火山引擎视频故障排查

提交前检查

按顺序检查：

1. /v1/models 是否能看到请求中的模型名称。
2. 令牌是否有该模型权限且额度充足。
3. Authorization 是否为正确的 Bearer 格式。
4. prompt 是否非空。
5. Seedance 专用参数是否放在 metadata。
6. 输入图片是否为上游可访问的 HTTPS URL，或有效的 asset:// 资产。

常见问题

模型不存在或没有可用渠道

可能原因：模型名拼写错误、别名未配置、令牌分组无权限、渠道被禁用或没有可用密钥。

处理：重新查询 /v1/models，复制实际模型名称；管理员检查渠道状态和模型映射。

图生视频没有读取图片

检查请求是否使用顶层 image、images，或在 metadata.content 中提供了正确的 image_url。不要同时使用两套输入方式。

时长或比例没有生效

当前 Seedance 适配器要求将它们写在 metadata：

{
  "metadata": {
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }
}

人脸或虚拟人审核失败

不要通过滤镜或重复提交规避审核。确认肖像权和素材来源；写实虚拟人按上游要求开通相应能力、上传资产并完成审核。详见虚拟人与人像素材。

长时间停留在排队或生成中

• 不要重复提交任务。
• 将轮询间隔调整到 10～30 秒。
• 记录任务 ID 和提交时间。
• 管理员检查上游任务状态、渠道日志和任务同步进程。

已完成但结果地址打不开

上游结果地址通常有有效期。任务完成后及时下载，或使用：

GET /v1/videos/{task_id}/content

该接口仍需携带当前用户的认证令牌。

实际扣费与预期不同

确认模型、分组倍率、分辨率、时长、输入类型和最终上游用量。以 NewAPI 使用日志中的最终记录为准。不要把教程中的单次测试结果当作固定单价。

提交问题时提供什么

建议提供：

• 请求时间和时区
• 请求接口
• 模型名称
• 公开任务 ID（task_...）
• HTTP 状态码
• 脱敏后的错误响应
• 是否为文生视频、图片 URL 或已审核资产

请删除 API Key、签名 URL、身份证明和未经授权的人像原图。