跳到正文
HopBase 文檔
登入控制台

並行、逾時與計費

並行上限、逾時、請求大小限制，以及什麼時候計費。

本頁是接入前需要知道的運行口徑。錯誤碼與重試規則見錯誤碼與重試。

並行

範圍預設可設範圍超限結果
帳戶同時在途 5 個請求可申請調高429 user_concurrency_limit
單把金鑰不另設上限在「API 金鑰」裡給金鑰設 1 以上的整數；留空或 0 = 不另設429 apikey_concurrency_limit
  • 兩者都設了時取更小的那個。
  • 對話、生圖、影片提交、/v1/messages/count_tokens 都佔並行；輪詢任務與 GET /v1/models 不佔。
  • 超限回傳 429 User concurrency limit reached, please retry later 或 API key concurrency limit reached, please retry later，並帶 Retry-After: 1。
  • 需要更高上限請聯絡我們調整。
並行滿了不是排隊，是直接拒絕：

超出上限的請求會立即回傳 429，不會在伺服器端排隊。請在用戶端自行限流，或依 Retry-After 重試。

逾時

情境伺服器端口徑用戶端讀取逾時建議
Gemini 官方直連的對話單次生成約 100 秒未完成即判逾時並自動重試，總等待可能更長不低於 240 秒
其他平台的非串流對話總時長有上限（Claude 300 秒，逾時 504），長上下文首字可能超過 1 分鐘不低於 300 秒；長輸出用串流
串流對話約 90～150 秒（依模型）無輸出，或中途靜默約 150 秒，即判卡住並重試或報錯；期間有心跳不低於 300 秒；重推理模型開啟推理摘要
同步生圖大圖常見 30～100 秒不低於 300 秒
非同步生圖、影片提交即回傳，結果靠輪詢；未完成任務 24 小時（Seedance）或 2 小時（可靈、Midjourney、萬相 / 快樂馬、MiniMax）後判失敗提交請求 60 秒即可

請求大小

限制項下限上限超限結果
請求內容（所有端點）—60 MB413 request_too_large
/v1/audio/speech 的 input（speech-2.8-hd / speech-2.8-turbo）1 字元4,096 字元400
/v1/t2a_v2 的 text（speech-2.8-hd / speech-2.8-turbo）1 字元10,000 字元400
/v1/audio/speech 的 input（seed-tts-2.0 / seed-icl-2.0 / seed-audio-1.0）1 字元seed-tts-2.0 與 seed-icl-2.0 5,000 字元，seed-audio-1.0 3,000 字元（按字元計，漢字也算 1 個）400
/v1/voice_clone 的錄音 audio（seed-icl-2.0）—解碼後 10 MB；請求主體 16 MiB400 / 413

base64 圖片和影片很容易超過 60 MB，建議壓縮後再傳，或在模型支援時改用 URL。長文字語音請在用戶端分段，詳見語音合成 API。各模型對素材的限制（圖片張數、檔案大小、時長）見對應模型文件。

計費

情況是否計費
請求成功依模型計價單位計費（token / 張 / 秒 / 字元——語音合成一個漢字按 2 計）
請求失敗（4xx、5xx）原則上不計費；已實際產出的部分按量計費（如 Responses 產出 token 後失敗）
串流輸出到一半中斷，或用戶端提前斷線依已經產出的部分計費
非同步任務失敗不計費

其他要點：

  • 餘額用完會被攔截：帳戶可用餘額小於等於 0 時，新請求直接回傳 402，不影響已在途的請求。
  • 影片提交會預留餘額：依預估費用預留，餘額是正的也可能因為「在途預留 + 本條預估」超出而回傳 402，任務結束後預留自動釋放。
  • 金鑰額度：給金鑰單獨設了額度時，額度用完回傳 402 insufficient_quota，文案為「API key quota exhausted」。

查餘額與用量

curl https://api.hop-base.com/v1/usage \
  -H "Authorization: Bearer sk-你的金鑰"

balance 是這把金鑰此刻還能花的額度。各欄位含義、單位與出錯情況見帳戶與目錄 API。明細請在主控台「使用記錄」查看。

圖片和影片結果連結的有效期各不相同，見圖片生成 API 與影片生成。

下一步

本頁目錄

並行逾時請求大小計費查餘額與用量下一步