核心指南
常见问题
请求被拒绝时该改什么
这里回答第一次接入时最容易挡住请求的问题。每条都指出被拒绝的字段,以及写清修法的文档页。
视频请求返回 400
POST /v1/videos/generations 会拒绝超出所选模型支持的 duration、seconds、resolution 或 operation 取值。错误正文列出可用的取值,改请求之前先读它:
allowed_durations:可接受的duration与seconds取值,单位为秒。allowed_resolutions:可接受的resolution取值。supported_operations:可接受的operation名称。recommended_request:一条使用允许取值的请求;当该 operation 需要只有你能提供的输入(例如image-to-video的图片)时不返回,改由required_selectors指出缺少的输入。
这些列表属于所选模型和你发送的 operation,其他模型的取值不适用。参见视频生成与创建视频。
Gemini 文件上传走不通
有两种方式不需要额外的上传步骤:把字节内联发送——在 OpenAI 兼容的 image_url.url 字段里放 data:image/png;base64,... 形式的 data URL,或在 Gemini 原生的 inlineData.data 里放不带 data: 前缀的原始 Base64;或者在 fileData.fileUri 里给一个公网 https URL。如果需要同一个文件被多次请求引用,请自行用 TokenLab 密钥把字节发到 POST /upload/v1beta/files,并使用返回的 file_uri。Google Gen AI SDK 自带的上传方法不由 TokenLab 提供,返回 404,重试不会成功。参见上传 Gemini 文件与Gemini Files 与缓存内容。
401 或 402
| 状态码 | 错误码 | 怎么做 |
|---|---|---|
401 | invalid_api_key | 用 Authorization: Bearer sk-... 发送密钥。已撤销或未激活的密钥会一直失败,需要 Workspace 重新创建密钥。 |
402 | insufficient_balance | 余额不足以支付该请求:充值、缩小请求,或换用价格更低的模型。 |
重试而不产生两个任务
POST /v1/videos/generations 请带上 Idempotency-Key。超时后用同一个 key 重发同一条请求,就能拿回原来的任务,而不是新建一个。参见处理 API 错误。