并发、超时与计费

本页是接入前需要知道的运行口径。错误码与重试规则见错误码与重试。

并发

范围	默认	可设范围	超限结果
帐户	同时在途 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 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。各模型对素材的限制（图片张数、文件大小、时长）见对应模型文档。

情况	是否计费
请求成功	按模型计价单位计费（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 与视频生成。