错误排查¶

HTTP 错误¶

状态码	常见原因	处理建议
`400`	JSON 无效、缺少模型或字段类型错误	校验 JSON；确认 `model`、`prompt` 在顶层
`401`	API 密钥缺失或无效	检查 `Authorization: Bearer ...`，重新创建已泄露密钥
`403`	密钥无模型/分组权限	检查密钥的模型限制、分组与账户权限
`404`	任务 ID 错误或任务不属于当前用户	使用提交时的同一密钥，并检查完整 `task_id`
`429`	额度不足、频率或并发受限	查看余额与限制，降低并发后退避重试
`5xx`	网关或上游临时异常	保留请求与任务 ID，有限次数重试

任务失败¶

提交成功只代表任务已受理。上游内容审核、素材下载或生成错误会在后续查询中以 status: failed 返回。

错误特征	原因	处理
`InputImageSensitiveContentDetected...`	图片包含真人、隐私或敏感内容	更换已获授权且符合规则的素材
`MissingParameter`	`content` 内 URL 结构错误	确认 `image_url.url` 等嵌套字段与 `type` 完全匹配
`missing_model`	缺少模型	把 `model` 放在请求顶层
`invalid character` / `Invalid request`	JSON 转义错误	使用 JSON 库生成请求，不手工拼接包含双引号的提示词
素材下载失败	URL 过期、需登录或有防盗链	换成公网可直接访问的 HTTPS 地址

参数看似成功但未生效¶

最常见原因是把 duration、ratio、resolution 或 content 放在顶层。Seedance 扩展参数必须放入 metadata：

{
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "...",
  "metadata": {
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }
}

后台“渠道测试”失败¶

异步视频不能用普通 Chat 测试方式判断可用性。后台通用渠道测试可能出现模型定价表达式、空 Token 指针或超时提示，而真实的视频提交接口仍可能正常。

请使用一个短时长、低分辨率的真实请求验证：

POST /v1/video/generations 返回任务 ID。
查询任务最终为 completed。
结果 URL 可访问。
控制台日志记录了正确模型、Token 和费用。

Docker 拉取超时（管理员）¶

出现 registry-1.docker.io ... context deadline exceeded 表示服务器访问 Docker Hub 超时，与 Seedance API 参数无关。管理员应检查服务器出口、DNS、镜像加速配置，并先手工拉取镜像后再重试宝塔安装。