百炼生成视频 API​

POST https://art-api.yuyuflow.com/v1/videos

创建百炼视频生成任务。支持万相（Wan）3.0 和 HappyHorse 1.1 系列模型的文生视频、图生视频和参考生视频。

任务为异步模式：创建成功后返回任务 ID，需通过查询接口轮询任务状态。

鉴权​

本接口仅支持 API Key 鉴权，请在 https://art-api.yuyuflow.com/dashboard/overview 获取 API Key。

Header​

请求参数​

Body 参数​

model string 必选

模型 ID。可选值：

prompt string 必选

文本提示词，描述要生成的视频内容。建议用自然语言描述场景、人物、动作、镜头运动等。

image string 图生视频必填

首帧图片的公网 URL。仅 happyhorse-1.1-i2v 使用。

支持的格式：jpeg、png、webp、bmp、tiff、gif。图片应小于 30 MB。

images string[] 参考生视频可选

参考图片 URL 数组，最多 9 张。仅 happyhorse-1.1-r2v 使用。

参考图片用于保持人物、场景、风格的一致性。多张参考图可以提供不同角度或风格的信息。

size string 默认 720p

分辨率。可选值：480p / 720p / 1080p（不区分大小写）。

duration integer 默认 5

视频时长（秒）。不同模型的范围：

metadata object 可选

扩展参数容器。通过 metadata.parameters 传入百炼原生参数。

metadata.parameters object​

metadata.parameters.ratio string 默认 16:9

宽高比。可选值：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。

metadata.parameters.watermark boolean 默认 false

是否在生成的视频中添加水印。

metadata.parameters.resolution string 可选

直接指定百炼原生分辨率参数（480P / 720P / 1080P）。与顶层 size 等效，同时指定时以此为准。

metadata.parameters.seed integer 可选

随机数种子。相同种子和参数可复现相似结果。

请求示例​

文生视频​

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
  }'

图生视频​

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
  }'

参考生视频 + 自定义宽高比​

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": "1080p",
    "duration": 10,
    "metadata": {
      "parameters": {
        "ratio": "9:16",
        "seed": 42
      }
    }
  }'

创建成功响应​

{
  "id": "cgt-xxxxxxxx",
  "status": "queued",
  "model": "wan3.0-video"
}

id string

任务 ID，用于后续查询。

status string

任务状态。创建成功后为 queued，表示任务已入队等待处理。

错误响应​

{
  "error": {
    "code": "invalid_parameter",
    "message": "duration must be between 2 and 30 for wan3.0-video"
  }
}

计费​

百炼视频采用按秒×分辨率计费。提交时按请求时长预扣额度，任务完成后按上游返回的实际视频时长差额结算（多退少补）。