Skip to content

火山引擎视频故障排查 ​

提交前检查 ​

按顺序检查:

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

常见问题 ​

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

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

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

图生视频没有读取图片 ​

统一检查 metadata.content 中的 image_url。当前插件会合并 images 和 metadata.content,不要重复引用;不要依赖旧入口顶层 image 的转换行为。

时长或比例没有生效 ​

当前 Seedance 插件从 metadata 读取这些专用参数;顶层 seconds 会覆盖 metadata.duration,不要传入冲突值:

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

人脸或虚拟人审核失败 ​

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

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

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

已完成但结果地址打不开 ​

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

text
GET /v1/videos/{id}/content

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

实际扣费与预期不同 ​

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

提交问题时提供什么 ​

建议提供:

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

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

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。