错误处理

适用场景

请求失败、任务超时、返回字段和预期不一致时，优先检查这里。

核心规则

先保留请求时间、路径、HTTP 状态码、脱敏后的请求体和响应体
视频任务请额外记录 id、task_id 或 video_id
若使用代理、跳过证书校验或公司网关，也要一并记录

常见问题

401 / 403

API Key 无效
Header 名称或格式错误
渠道和密钥不匹配

400

JSON 结构错误
多模态内容数组格式错误
图片字段数量超出限制

404

使用了错误的接口路径
模型名拼写不正确
对已过期任务 ID 发起轮询

视频任务长时间处理中

输入图片 URL 外网不可达
轮询策略过于激进
任务本身耗时较长，未设置足够超时时间

排查清单

确认 Base URL 和接口路径完全正确
确认 Authorization 头存在且格式正确
检查图片 URL 是否公网可访问
检查模型名、尺寸、时长等枚举值是否合法
视频任务请轮询 GET /v1/videos/{id} 并保留完整状态字段

下一步

更完整的联调资料见排查建议。