常見問題
簡短回答，每條都可單獨閱讀。要填入 model 的確切名稱，請看 模型 頁面；當前價格見 oceantoken.ai 上各模型的頁面。
OceanToken 是什麼？
OceanToken 是一個 API 加一份預付餘額，可呼叫超過 500 個 AI 模型：來自 OpenAI、Anthropic、Google、DeepSeek、Qwen、ByteDance 以及約 60 家其他發布者的文字、圖片、影片、語音合成、轉錄、嵌入與重排序模型。你只要建立一個帳戶、儲值、建立 API Key，就能用同一個 Base URL 和同一把 Key 呼叫任何模型。每個模型的價格、上下文視窗和能力都在呼叫前列於目錄中。
OceanToken 相容 OpenAI 嗎？哪些 SDK 可以用？
可以。OceanToken API 說的是 OpenAI API，因此 Python、TypeScript 等語言的官方 OpenAI SDK 只要改兩個值就能用：Base URL 改成 https://api.oceantoken.ai/v1，API Key 改成你的 OceanToken Key。所有聊天模型（包括 Claude、GPT、Gemini 和 DeepSeek）也在 /v1/messages 回應 Anthropic Messages API，所以 Anthropic SDK 做同樣兩處修改就能直接用；它使用的 Base URL 是 https://api.oceantoken.ai，/v1 會由 SDK 自行加上。Chat Completions、Responses API、圖片、影片、嵌入、語音合成、轉錄和重排序都遵循相同的格式。
透過 OceanToken 可以呼叫哪些 AI 模型？
目錄共有超過 500 個模型，分為 7 種類型：語言模型（GPT、Claude、Gemini、DeepSeek、Qwen、GLM、Kimi、Grok、Mistral、Llama 等）、圖片生成與編輯模型、影片生成模型、文字轉語音、語音轉文字、文字嵌入和重排序模型。「模型」頁面列出每個模型的確切模型 ID、單價、上下文視窗，以及是否支援推理、工具呼叫或圖片輸入。每次發布文件時，這份清單都會從線上服務重新產生。
OceanToken 怎麼收費？有平台費嗎？
按用量付費，價格以每個模型標示的為準，以美元計，從預付餘額扣除；沒有訂閱。模型按用量計價，不收平台費；儲值時結帳另加手續費（按實付總額的 2.9% + $0.30 計，所有付款方式相同），不計入餘額，例如儲值 $100 實付 $103.30。語言模型按每 100 萬個輸入、快取輸入和輸出 token 計價（模型對快取寫入收費時也計入）；圖片按張、按百萬像素或按圖片 token 計價；影片按秒；語音合成按每 1,000 個字元；轉錄按音訊分鐘數；Cohere 重排序按搜尋單位。模型價格在一天中的任何時段都相同，smart-router 按它選中的模型價格計費。部分模型帶有 :free 標記，免費但吞吐量有限。呼叫前，可在 oceantoken.ai 上每個模型的頁面查看目前價格。
為什麼我的 Claude 提示詞沒有被快取？
Claude 只在請求要求時才快取提示詞。在 /v1/chat/completions 或 /v1/messages 上，在某個內容區塊加上 "cache_control": {"type": "ephemeral"}，標記重複部分的結尾；從下一個請求起，這部分會從快取讀取，並按模型的快取輸入價格計費。GPT、DeepSeek、Qwen 和 GLM 模型會自行快取。命中會顯示在 usage 中：Chat Completions 是 prompt_tokens_details.cached_tokens，/v1/messages 是 cache_read_input_tokens。Claude 只快取超過最小長度的前綴，依模型不同為 512 到 4,096 個 token。API 參考有兩種格式的範例。
如何在 Claude Code、Codex、Cursor 或 Gemini CLI 中使用 OceanToken？
在終端機執行一條命令並登入：npx -y @oceantoken/cli@latest connect codex（或 claude-code、cursor、gemini、openclaw）。它會為該代理加入位於 https://mcp.oceantoken.ai/mcp 的 OceanToken MCP 伺服器和 3 個技能，之後代理就能搜尋模型、估算費用，並從你的餘額產生圖片、影片和語音。AI 代理也可以自行依照 https://mcp.oceantoken.ai/install 的說明完成安裝。同一把 API Key 設定 Base URL 後，就能用在任何相容 OpenAI 的工具中。
OceanToken 能產生圖片、影片和語音，而不只是文字嗎？
可以。圖片模型在 /v1/images/generations 和 /v1/images/edits 回應，影片模型在 /v1/videos 以非同步任務執行、由你輪詢結果，文字轉語音在 /v1/audio/speech，轉錄在 /v1/audio/transcriptions，嵌入在 /v1/embeddings，重排序在 /v1/rerank。7 種類型都用同一把 Key 和同一份餘額，每個請求都會連同費用和延遲出現在主控台的「日誌」中。圖片和影片的下載網址有效 24 小時，影片任務接受 Idempotency-Key，因此重試永遠不會啟動並計費第二個任務。
可以限制一把 API Key 能花多少錢嗎？
可以。每把 API Key 都能設定自己的額度上限（可選擇每天、每週或每月重設）以及到期日，讓測試專案或同事用的 Key 無法從共用餘額中支出超過你允許的金額；用完額度的 Key 會收到 400 key_budget_exceeded 錯誤，即使帳戶仍有餘額。主控台顯示每把 Key 的用量，「日誌」頁面列出每個請求的模型、token、費用和延遲。Key 只在建立時顯示一次，輪替時可保留 24 小時的重疊期。
計費和預付餘額是怎麼運作的？
你在主控台用信用卡儲值，可選 $5、$10、$25 或 $50，也可以自行輸入金額。儲值時結帳另加手續費（按實付總額的 2.9% + $0.30 計，所有付款方式相同），不計入餘額。首次儲值另贈所購額度的 10%，最多 $100（規則見「儲值」頁的「首儲贈送」：https://docs.oceantoken.ai/zh-Hant/get-started/add-credits#first-top-up-bonus ）。每個請求都會按呼叫當下該模型的標示價格，從預付餘額扣除確切費用，絕不追溯調整。購買的餘額自購買起 12 個月內有效（服務條款第 6 條），沒有每月最低消費。餘額等於或低於 $0 時，付費模型的請求都會被拒絕，直到你儲值為止（模型 ID 以 :free 結尾的模型仍可呼叫）；影片這類長任務會先預留預估費用，直到完成。「用量」頁面按天、按模型顯示支出。
OceanToken 有免費方案嗎？
模型 ID 以 :free 結尾的模型呼叫免費，但吞吐量有限且不保證；「模型」頁面的篩選會以 Free 標籤標出它們。餘額為 $0 時也能呼叫它們，呼叫也不會減少餘額，所以你可以在不花錢的情況下測試 API 格式、SDK 設定和代理整合，之後只要改模型 ID 就能換成付費模型。
OceanToken 的速率限制和逾時是多少？
速率限制按 API Key 計算，分為每分鐘請求數和每分鐘 token 數，回應會在 x-oceantoken-key-rpm-limit 和 x-oceantoken-key-tpm-limit 標頭中帶上該 Key 的限制；超過時回傳 429 rate_limited 並附 Retry-After 標頭。同步請求最多執行 240 秒，請求內容最大 10 MB，因此長文字生成應使用 stream: true，大檔案應以網址傳送。影片生成以任務形式執行，需要數分鐘，所以要輪詢 /v1/videos/{video_id}，而不是保持連線。詳情見「限制」頁面。
如果模型供應商故障會怎樣？
通常你什麼都察覺不到。許多模型（包括目前的 Claude 和 GPT 模型）有不只一條官方或授權管道；當某條失敗、滿載或沒有回應時，OceanToken 會重試請求，並以相同價格改走同一模型的另一條管道。除非你用 fallbacks 參數自行指定備用模型，否則它絕不會用另一個模型回答；在產生輸出前就失敗的嘗試不計費。任何管道都會回傳的錯誤（例如格式錯誤的請求或安全拒絕）會直接回傳給你；串流在開始輸出後中斷時，可能以錯誤結束，所以請對 429 和 5xx 保留帶退避的重試。「重試與容錯移轉」頁面有詳細說明。