跳到主要内容

错误与排查

排查 API 问题时，优先确认状态码、错误类型、Request-Id、traceId 和模型名称。

常见错误​

状态码常见原因处理建议
400请求体字段错误、模型不支持该参数对照对应接口参考检查字段名、类型和必填项
401API Key 缺失、错误或已失效检查 Authorization 请求头；若使用 Anthropic / Google SDK，再确认 x-api-key 或 x-goog-api-key 是否已随请求带出
403账户无权限、模型未开通、BYOK 权限不足检查控制台权限或提交工单
404endpoint 或模型不存在确认路径、模型 ID 和协议是否匹配
429超过速率限制降低并发，加入指数退避
500 / 502 / 503平台或上游供应商异常稍后重试，并保留 traceId

排查信息​

提交工单时建议提供：

  • 请求时间
  • endpoint
  • model
  • Request-Id
  • 响应里的 traceId
  • 错误响应体
  • 脱敏后的请求示例

异步视频任务​

如果是 Veo 视频生成问题，请额外提供 task_id。提交请求后可到 任务中心 查看生成状态和下载结果。

下一步​