同時実行数、タイムアウト、課金

同時実行数の上限、タイムアウト、リクエストサイズ、課金されるタイミング。

導入前に知っておくべき実行時のルールです。エラーはエラーコードと再試行を参照してください。

同時実行数

対象	既定値	設定範囲	超過時
アカウント	同時 5 リクエスト	申請により引き上げ可	429 `user_concurrency_limit`
API キー	キー単位の上限なし	「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 公式直結プランのチャット	1 回の生成が約 100 秒で終わらなければタイムアウトとして再試行するため、総待ち時間は長くなることがあります	240 秒以上
その他プラットフォームの非ストリーミングチャット	合計時間に上限あり（Claude は 300 秒で 504）。長いコンテキストでは最初のトークンまで 1 分以上かかることがあります	300 秒以上。長い出力はストリーミングで
ストリーミングチャット	約 90〜150 秒（モデルによる）出力がない、または途中で約 150 秒途切れると停止と判定し、再試行またはエラー終了。その間もハートビートあり	300 秒以上。重い推論モデルでは推論サマリーを有効に
同期での画像生成	大きな画像では 30〜100 秒が一般的です	300 秒以上
非同期の画像生成、動画	送信は即時応答し、結果はポーリングで取得します。未完了タスクは 24 時間（Seedance）または 2 時間（Kling、Midjourney、Wan / HappyHorse、MiniMax）で失敗	送信リクエストは 60 秒で十分です

制限項目	最小	最大	超過時
リクエストボディ(全エンドポイント)	—	60 MB	413 `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 MiB	400 / 413

base64 の画像や動画はすぐに 60 MB に達するため、圧縮するか、モデルが対応していれば URL を渡してください。長い音声原稿はクライアント側で分割してください。詳細は音声合成 API。素材ごとの制限(画像枚数、ファイルサイズ、長さ)は各モデルのガイドに記載しています。

状況	課金
リクエスト成功	あり（モデルの課金単位: トークン / 枚 / 秒 / 文字。音声合成では漢字 1 文字を 2 と数えます）
リクエスト失敗（4xx、5xx）	原則なし。生成済みの分は課金（例: トークン生成後に失敗した Responses）
ストリームが途中で中断、またはクライアントが先に切断	あり（生成済みの分のみ）
非同期タスクの失敗	なし

その他の要点:

残高切れで新規リクエストは拒否: 利用可能残高が 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 と動画生成を参照してください。