常見問題

TokSpan 是一個統一的 AI API 閘道，為您提供單一 OpenAI 相容端點，即可存取來自 50 多家供應商的 200 多個模型——包括 OpenAI、Anthropic、Google、Meta、DeepSeek 等。

運作方式如下：您以標準 OpenAI 格式向 TokSpan 的 API 傳送請求。TokSpan 將您的請求路由至適當的上游供應商，必要時轉換格式，處理回應後返回給您。從您的角度來看，您呼叫的是一個 API——TokSpan 在背後管理模型路由、負載平衡、速率限制、自動容錯移轉及成本追蹤。

您只需要一個 TokSpan 帳號。我們為您處理所有上游供應商關係——無需分別註冊 OpenAI、Anthropic 或 Google 帳號。

• 一把金鑰，所有模型——使用單一 API 金鑰即可存取 GPT-4o、Claude Opus、Gemini Pro 和 DeepSeek V3。無需管理不同供應商的多個計費帳號。
• 無供應商鎖定——只需更改一個參數即可切換模型。無論由哪個供應商提供服務，您的程式碼保持不變。
• 自動容錯移轉——若供應商發生故障，流量會自動路由至您的備用模型。無需人工介入。
• 全球覆蓋——服務全球開發者的全球邊緣網路。
• 成本可視性——在單一儀表板中跨所有模型和供應商的統一計費與即時使用量追蹤。

入門大約只需 5 分鐘：

1. 在 api.tokspan.com/register 註冊
2. 透過信用卡、PayPal 或銀行轉帳為您的帳號新增點數
3. 從儀表板 → API 金鑰頁面建立 API 金鑰
4. 進行第一次呼叫——只需將 base_url 更改為 https://api.tokspan.com/v1 並使用您的新金鑰

若您已在使用 OpenAI SDK，只需 30 秒即可完成。請參閱快速入門指南以取得 Python、TypeScript 和 curl 的程式碼範例。

我們不提供永久免費方案——原因如下，這實際上對您有利：

• 無補貼性的品質下降——大規模的免費方案需要在基礎架構、支援或模型存取上偷工減料。我們將一切投資於可靠性和模型覆蓋範圍。
• 只需為實際用量付費——無最低承諾。充值任意金額即可。大多數開發者在測試的第一個月花費不到 $5。
• 所有模型，無限制——您的付費餘額讓您立即存取平台上的所有前沿模型——沒有「免費方案限定」的模型限制。

新帳號可能不時獲得推廣用的起始點數。註冊後請查看儀表板。

我們提供200 多個模型的存取，涵蓋所有主要類別：LLM（GPT-4o、Claude Opus 4.8、Gemini 2.5 Pro、DeepSeek V3、Llama 4、Mistral Large 3）、視覺與多模態、嵌入與重新排序，以及語音與音訊（TTS + STT）。

請在 api.tokspan.com/pricing 瀏覽完整的即時目錄及當前每 Token 定價。請參閱模型文件以取得類別概覽和功能比較。

TokSpan 在每個供應商的基礎費率上加收小額、透明的服務費。您支付所消耗的 Token 費用，外加涵蓋我們基礎架構、路由、全球邊緣網路和支援的利潤。

每個模型的每 Token 價格（含服務費）在您進行呼叫前，即可在 Model Hub 上即時查看。您看到的價格就是您支付的價格——無隱藏費用，無意外帳單。

無月費訂閱，也無最低承諾。充值任意金額即可立即開始呼叫模型。

我們為全球客戶提供多種付款選項：

• 信用卡／簽帳金融卡——透過 Stripe 接受 Visa、Mastercard、American Express。適用標準卡片處理手續費。
• PayPal——適用於 200 多個國家和地區。
• 銀行轉帳（電匯）——適用於企業帳號（最低發票金額：$500）。處理時間：1–3 個工作日。

所有付款均以美元計價。信用卡／PayPal 付款後餘額立即更新；電匯在確認後才會顯示。

是的，政策如下：

• 信用卡／PayPal 付款——未使用的點數可在購買後 7 天內申請退款。已消耗 Token 的平台服務費（我們在供應商費率上加收的利潤）不予退款。
• 銀行轉帳——退款將在 5–10 個工作日內處理，扣除所有電匯手續費。

若要申請退款，請將您的帳號電子郵件和付款詳情寄送至 support@tokspan.com。

是的。未使用的點數將在購買後 12 個月過期。此政策使我們能夠管理供應商端的責任，同時盡可能降低服務費。您將在點數過期前 30 天和 7 天收到電子郵件提醒。過期日期可在儀表板的計費 → 點數下查看。

自動充值可確保您的餘額永遠不會歸零：

1. 前往儀表板 → 計費 → 自動充值
2. 設定閾值（例如 $5——當餘額低於此值時，我們會觸發充值）
3. 設定金額（例如 $20——每次充值的金額）
4. 選擇您的付款方式

每次自動充值您都會收到電子郵件收據。您可以隨時停用或調整。我們建議為生產工作負載啟用此功能，以避免 402 中斷。

您有多層成本控制機制：

• 每金鑰每月預算——為每個 API 金鑰設定嚴格的消費上限。當金鑰達到上限時，請求將被拒絕，直到您提高限制或週期重置。
• 每模型速率限制——為每個 API 金鑰設定自訂的 RPM（每分鐘請求數）和 TPM（每分鐘 Token 數）限制。
• 模型白名單——將金鑰限制為僅能使用特定模型（例如，僅允許開發金鑰使用較便宜的模型）。
• IP 白名單——將金鑰使用限制為特定 IP 位址或範圍。
• 即時使用量儀表板——在儀表板中按金鑰、模型和時間段監控消費。

所有限制均在建立或編輯金鑰時從儀表板 → API 金鑰 設定。請參閱金鑰範圍設定以取得詳細資訊。

Token 的計算方式與上游供應商完全一致：Prompt Token + 補全 Token = 總計費 Token。我們透傳每個供應商的 Token 化器，因此計數與您直接呼叫供應商時看到的數量相符。

對於多模態輸入（圖片、音訊、影片）：每個供應商有其自己的公式將媒體轉換為 Token 等效值。我們透傳供應商的計算結果——您的儀表板顯示最終的 Token 數量和成本。一般來說：高解析度圖片每張約 85–170 Token（GPT-4o），音訊約每秒 50 Token（Whisper）。

對於支援 Prompt 快取的模型（Claude、GPT-4o），已快取的 Prompt Token 按供應商的折扣快取費率計費。您的使用量儀表板會區分一般與快取 Token 的消費明細。

不會——我們不儲存您的 Prompt 或補全內容。您的資料僅即時流經我們的基礎架構，不會被持久化。我們僅記錄請求的中繼資料（模型、Token 數量、時間戳記、API 金鑰 ID），用於計費準確性和濫用防範。這是計算您的用量和保護平台所必需的。

我們絕不使用您的 Prompt 或補全內容進行模型訓練，也絕不出售或與第三方分享您的資料。

若您需要零資料可見性（即您不希望我們看到任何中繼資料），TokSpan 完全支援自託管——部署在您的防火牆後方，享有完全的資料主權。請參閱下方我可以自託管嗎？。

這取決於供應商和您的設定：

• OpenAI——不會使用 API 呼叫進行訓練（自 2023 年 3 月起）。預設情況下，透過 API 傳送的資料不會用於模型訓練。
• Anthropic——不會使用 API 資料進行訓練。除非您明確選擇加入，否則 Claude API 資料不會用於模型改進。
• Google (Gemini)——不會使用付費 API 使用量進行訓練。免費方案的使用量可能適用不同條款。
• 其他供應商——政策各異。請查閱各供應商的條款。若此為您的關注點，我們建議您檢閱供應商的資料使用政策。

為獲得最大控制權，請自託管 TokSpan，並設定具有明確不訓練政策的上游供應商 API 金鑰。您完全可以控制哪些供應商會接觸到您的資料。

所有 API 金鑰皆經靜態加密（AES-256）。金鑰僅在建立時顯示一次 — 我們無法復原遺失的金鑰（您需產生新金鑰並撤銷舊金鑰）。所有 API 流量在傳輸過程中皆以 TLS 1.3 加密。我們建議對 API 金鑰使用IP 白名單、模型範圍限制和每月消費上限來建立縱深防禦。每 90 天輪換金鑰是一項安全最佳實踐。

安全性是 TokSpan 的基石。我們的基礎架構圍繞以下控制措施建構：

• TLS 1.3 — 所有傳輸中的資料全程端對端加密。
• AES-256 — API 金鑰與憑證靜態加密。
• MFA — 所有帳戶皆支援多重要素驗證。
• 符合 GDPR 的實務 — 資料最小化與隱私揭露已於我們的《隱私權政策》中說明。

企業客戶可透過 support@tokspan.com 索取我們安全態勢的更多詳細資訊。

是的。我們的託管服務落實 GDPR 與 CCPA 要求：資料最小化（我們不儲存您的提示詞/補全內容）、目的限制（中繼資料僅用於計費與濫用防範）、依要求刪除使用者資料，以及透明的資料處理揭露。

針對嚴格的資料駐留與合規要求，自託管讓您擁有完全控制權 — 在您自己的基礎設施上、任何區域、防火牆後方部署 TokSpan。請聯絡 support@tokspan.com 索取 DPA（資料處理協議）。

您可以從儀表板 → 設定 → 帳戶 → 刪除帳戶刪除您的帳戶及所有相關資料。帳戶刪除為永久且不可逆。

關於您的餘額：

• 刪除時任何剩餘點數將被沒收。我們建議您在啟動刪除前先使用餘額或申請退款。
• 法律要求的計費記錄（付款收據、發票）將依法定期限保留 — 通常為 7 年。
• 所有其他帳戶資料（API 金鑰、使用記錄、電子郵件、設定）將在 30 天內永久清除。

是的。DPA 適用於企業與團隊帳戶。我們提供標準 DPA，涵蓋 GDPR 資料處理者義務、子處理者揭露、跨境傳輸保障（SCC）及資料外洩通知承諾。請聯絡 support@tokspan.com 並附上您法務團隊的需求 — 一般處理時間為 2–3 個工作日。

是的，100%。將 base_url 更改為 https://api.tokspan.com/v1，您現有的 OpenAI SDK 程式碼即可立即運作 — Python、Node.js、Go、curl 或任何 OpenAI 相容的函式庫。

支援的功能：

• Chat Completions — 完整支援，包括 system/user/assistant 訊息
• 串流 — SSE（伺服器傳送事件），使用 stream: true
• Function / Tool Calling — 並行工具呼叫、strict 模式
• JSON 模式 — 使用 response_format 的結構化輸出
• 視覺 / 圖片輸入 — URL 與 base64 圖片
• Embeddings — 跨多個供應商的完整支援
• 音訊 — TTS（文字轉語音）與 STT（語音轉文字 / Whisper）
• 圖片 — 透過 DALL·E 與相容模型生成
• Rerank — 完整支援
• 推理力度 — 透過模型後綴控制推理深度（見下方）

在模型名稱後附加後綴以控制推理深度：

若未提供後綴，將使用模型的預設推理層級。這讓您無需更改整合程式碼，即可按每次請求在速度、成本與答案品質之間取得平衡。詳情請參閱模型 → 推理力度。

除了推理後綴之外，TokSpan 還支援路由導向的變體，用於控制請求的分派方式：

在支援的情況下可組合後綴：例如 gpt-5-high-fast 可獲得最大推理深度與最低延遲路由。請參閱模型文件了解各模型的後綴相容性。

是的。當上游供應商支援時（Claude、GPT-4o、Gemini），Prompt Caching 會自動套用。當您跨多次請求傳送相同的提示詞前綴時，供應商會快取計算結果，並對已快取的部分以折扣費率計費 — 通常為完整提示詞 token 價格的一折。

您無需更改程式碼。TokSpan 會傳遞供應商的快取狀態，您的儀表板會顯示已快取與未快取的 token 使用量。最大化快取命中率的方法：

• 將靜態內容（系統提示詞、上下文文件）放在提示詞的開頭
• 將動態內容（使用者訊息、最新查詢）放在結尾
• 在多次請求中重複使用相同的系統提示詞

閱讀完整最佳化指南：Prompt Caching。

是的。TokSpan 支援 Bring Your Own Key — 您可以在儀表板中新增自己的 OpenAI、Anthropic、Google 或其他供應商的 API 金鑰。設定 BYOK 後：

• 該供應商的請求將透過您的金鑰路由，而非 TokSpan 的金鑰池
• 您直接向供應商付款 — TokSpan 對 BYOK 請求不收取服務費
• 您仍可使用 TokSpan 的統一端點、容錯移轉與成本追蹤
• 混合使用 BYOK 金鑰與 TokSpan 金鑰池：主要供應商使用自己的金鑰，其他則使用我們的池作為備援

BYOK 非常適合與供應商已有合作關係、享有企業折扣或有嚴格計費分離需求的團隊。請從儀表板 → 設定 → 供應商金鑰進行設定。

TokSpan 返回標準 HTTP 狀態碼：

我們建議對 429 和 5xx 錯誤實作帶有抖動的指數退避。請參閱錯誤代碼獲取包含錯誤回應主體的完整參考。

我們的託管 API 目標為99.99% 正常運作時間。我們的基礎設施跨多個可用區域水平擴展，無單點故障。針對關鍵任務工作負載，自託管部署讓您完全掌控可用性目標。

企業方案包含正式 SLA，涵蓋正常運作時間承諾、點數罰則及優先事件回應。請聯絡 support@tokspan.com 了解 SLA 條款。

TokSpan 會自動容錯移轉至您的下一個偏好模型。我們的系統：

1. 在數秒內偵測供應商不可用狀態（5xx 錯誤、逾時）
2. 跳過近期曾發生中斷的供應商（30 秒冷卻視窗）
3. 將請求路由至容錯移轉鏈中的下一個模型（可在儀表板 → 頻道中設定）

設計良好的鏈（例如 GPT-4o → Claude Opus → Gemini Pro）可確保零請求遺失。您只需為最終處理請求的模型付費 — 失敗的嘗試不計費。請參閱自動容錯移轉了解設定說明。

TokSpan 增加的路由開銷極小 — API 請求通常低於 100 毫秒。主要的延遲因素來自上游模型的生成速度（首 token 時間與每秒 token 數），這不受透過 TokSpan 路由的影響。

針對對延遲敏感的應用：

• 啟用串流（stream: true），讓使用者在 token 生成時即可看到
• 使用 -fast 模型後綴，自動路由至延遲最低的供應商
• 在您的應用所在區域部署自託管執行個體，實現零網路開銷

是的。請查看API 狀態頁面獲取即時服務健康狀態、事件歷史記錄及排定的維護時段。可透過電子郵件、Slack 或 Webhook 訂閱事件通知 — 請參閱Webhooks了解設定方式。

登入儀表板，前往API 金鑰，點擊+ 新增金鑰。為每個金鑰取一個描述性名稱（例如「production-backend」、「mobile-app-dev」、「staging-test」）。您可以建立無限數量的金鑰。

我們強烈建議為每個環境建立獨立金鑰（開發、staging、生產）。每個金鑰擁有獨立的使用量追蹤、消費上限和模型範圍限制 — 讓您輕鬆監控每個環境或用戶端的成本。若開發金鑰遭到入侵，您的生產金鑰不受影響。

從儀表板立即撤銷 — 撤銷即時生效（60 秒內完成傳播）。產生新金鑰並更新您的應用程式。刪除舊金鑰前，請監控使用記錄中是否有任何可疑活動。

防範最佳實踐：

• 使用IP 白名單限制金鑰的使用來源
• 設定每月消費上限以限制金鑰洩露時的影響範圍
• 每 90 天輪換金鑰
• 絕不將金鑰提交至版本控制 — 使用環境變數或密鑰管理器

從儀表板為每個環境建立獨立 API 金鑰：

• 開發 — 嚴格的消費上限（$10/月），限制使用較便宜的模型，無 IP 限制（供本機開發使用）
• Staging — 適度上限（$50/月），使用與生產相同的模型，IP 限制為您的 staging 伺服器
• 生產 — 依需求設定較高上限，可使用所有模型，IP 限制為您的生產伺服器

每個金鑰擁有獨立的使用量儀表板、警報和活動記錄。此設定讓您獲得各環境的成本可視性，並防止開發階段的錯誤耗盡生產預算。請參閱金鑰範圍限制獲取完整設定參考。

是的。TokSpan 可透過 Docker、Docker Compose 或 Kubernetes 部署至您自己的基礎設施。自託管讓您擁有：

• 完全的資料主權 — 資料永遠不會離開您的基礎設施
• 完整的記錄控制 — 您決定記錄什麼以及儲存在何處
• 零延遲開銷 — 在您的應用所在區域部署
• 無限制自訂 — 依您的需求調整平台

請參閱我們的部署指南，或聯絡 support@tokspan.com 尋求協助。

是的。TokSpan 支援團隊與企業部署，並提供專屬管理控制：

• 團隊工作區 — 子金鑰、角色及每金鑰用量限制
• 合併計費 — 跨所有模型與團隊的單一發票
• 自訂速率限制 — 依您的工作負載調整

請聯絡 support@tokspan.com 了解專屬部署選項。

是的。企業方案包含：

• 專屬客戶經理 — 所有問題的單一聯絡窗口
• 優先支援 — 保證回應時間（重大問題通常 2 小時內）
• 自訂 SLA — 根據您的需求量身打造的正常運作時間承諾與點數罰則
• 合併發票 — Net-30/60 付款條件、採購訂單、多幣種計費
• 自訂速率限制 — 根據您的工作負載調整 RPM/TPM 限制
• 部署協助 — 架構審查、Helm chart 自訂、地端設定

請聯絡 support@tokspan.com 提供您的需求 — 我們將在 1 個工作日內提出方案。

我們的託管基礎設施目前跨全球邊緣位置處理資料以實現最佳延遲。針對嚴格的資料駐留要求（例如 GDPR 要求資料必須留在歐盟，或特定國家法規），TokSpan 可完全自託管 — 在您自己的伺服器上、任何區域、防火牆後方部署，擁有完全的資料主權。

企業客戶也可洽談由我們團隊管理的專屬區域部署。請聯絡 support@tokspan.com 了解您目標區域的可用性。

我們提供多種支援管道：

• 電子郵件 — support@tokspan.com 處理計費、帳戶及技術問題。我們在 24 小時內回覆；大多數問題在單次往來中即可解決。
• 狀態頁面 — API 狀態提供即時事件更新。訂閱以在中斷期間接收通知。

企業客戶可獲得與我們工程團隊的共享 Slack 頻道，進行即時協作。