核心指南

常见问题

请求被拒绝时该改什么

这里回答第一次接入时最容易挡住请求的问题。每条都指出被拒绝的字段,以及写清修法的文档页。

视频请求返回 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

状态码错误码怎么做
401invalid_api_key用 Authorization: Bearer sk-... 发送密钥。已撤销或未激活的密钥会一直失败,需要 Workspace 重新创建密钥。
402insufficient_balance余额不足以支付该请求:充值、缩小请求,或换用价格更低的模型。

参见身份验证、账单与定价与处理 API 错误。

重试而不产生两个任务

POST /v1/videos/generations 请带上 Idempotency-Key。超时后用同一个 key 重发同一条请求,就能拿回原来的任务,而不是新建一个。参见处理 API 错误。

本页内容