百炼视频接入指南​

百炼视频生成采用异步任务模式：先创建任务取得 id，再查询任务状态，成功后读取 content.video_url。

百炼视频模型基于阿里云通义万相（Wan）和 HappyHorse 系列，支持文生视频、图生视频和参考生视频，最长可生成 30 秒有声视频。

开始前请准备：

1. 在 控制台 创建 API Key。
2. 确认当前账号已开通对应模型。
3. 所有客户请求都发送到当前平台地址：https://art-api.yuyuflow.com。

1. 创建视频任务​

文生视频​

curl -X POST "https://art-api.yuyuflow.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "一只橘猫坐在窗边打哈欠，清晨自然光，镜头缓慢推进",
    "size": "720p",
    "duration": 5
  }'

创建成功后会返回任务 ID：

{
  "id": "cgt-xxxxxxxx",
  "status": "queued"
}

请保存这个 id。创建成功只代表任务已提交，不代表视频已经生成完成。

图生视频​

happyhorse-1.1-i2v 支持图片输入生成视频，通过 image 字段传入图片 URL：

curl -X POST "https://art-api.yuyuflow.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "让画面中的人物微笑点头",
    "image": "https://example.com/portrait.png",
    "size": "720p",
    "duration": 5
  }'

参考生视频​

happyhorse-1.1-r2v 支持最多 9 张参考图片，通过 images 数组传入：

curl -X POST "https://art-api.yuyuflow.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "保持人物风格，切换到海边场景",
    "images": [
      "https://example.com/ref1.png",
      "https://example.com/ref2.png"
    ],
    "size": "720p",
    "duration": 5
  }'

指定宽高比​

通过 metadata.parameters.ratio 指定宽高比，默认为 16:9：

{
  "model": "wan3.0-video",
  "prompt": "城市夜景延时摄影",
  "size": "1080p",
  "duration": 10,
  "metadata": {
    "parameters": {
      "ratio": "9:16"
    }
  }
}

支持的宽高比：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。

2. 查询任务状态​

curl "https://art-api.yuyuflow.com/v1/videos/cgt-xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

任务状态通常按以下流程变化：

queued → running → succeeded
                 ↘ failed

建议前 30 秒每 2～3 秒查询一次，之后每 5～10 秒查询一次。

3. 保存视频结果​

成功响应示例：

{
  "id": "cgt-xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "resolution": "720p",
  "duration": 5
}

模型与参数​

参数说明​

分辨率与宽高比​

宽高比通过 metadata.parameters.ratio 指定，不同宽高比适用于不同场景：

计费说明​

百炼视频采用按秒×分辨率计费：

计费公式：时长（秒）× 分辨率单价。提交时按请求时长预扣，任务完成后按上游返回的实际时长差额结算（多退少补）。

常见问题​

• 创建任务返回 400：检查 model 是否正确、prompt 是否为空、duration 是否在模型允许范围内。
• 图生视频失败：确认 image 字段为可访问的公网 URL，不支持 Base64。图片格式支持 jpeg、png、webp。
• 参考生视频参考图过多：happyhorse-1.1-r2v 最多支持 9 张参考图片，超出会被拒绝。
• 宽高比不生效：确认通过 metadata.parameters.ratio 传入，不是顶层 ratio 字段。
• 结果 URL 下载失败：先解析 JSON，再读取 content.video_url；URL 应在有效期内（24 小时）使用。
• happyhorse-1.0-t2v 不可用：该模型已下线，请使用 happyhorse-1.1-t2v。

继续阅读​

• 百炼生成视频 API：完整参数参考
• 查询视频 API：完整响应字段
• Seedance 视频生成接入指南