首页/开放能力
videoGenerateChannel

视频生成(渠道)

通过 SOULDREAM 渠道直接生成 Seedance 视频,不对参考素材或结果视频做媒体后处理;支持 9 图 + 3 视频 + 3 音频参考素材。

2.0 480P 5积分/秒;720P 10积分/秒;Fast 480P 4积分/秒;720P 8积分/秒;Mini 480P 3积分/秒;720P 6积分/秒

基础说明

通过 SOULDREAM 渠道直接生成 Seedance 视频,不对参考素材或结果视频做媒体后处理;支持 9 图 + 3 视频 + 3 音频参考素材。

提交任务

提交 Seedance 2.0 / Seedance 2.0 Fast / Seedance 2.0 Mini 渠道视频生成任务,模型请求由 SOULDREAM 渠道处理。

POST/api/third-party/videoGenerateChannel/generate

请求头

字段类型必填说明
X-API-Tokenstring平台提供的调用凭证,用于识别当前账号或租户。
Content-Typestring提交任务时固定使用 application/json。

请求参数

字段类型必填说明
modelstring视频模型,传 seedance-2.0、seedance-2.0-fast 或 seedance-2.0-mini。
promptstring视频生成提示词,描述镜头、动作、主体、背景与风格。
imagesstring[]图片素材 URL 列表,最多 9 张。
videosstring[]参考视频 URL 列表,最多 3 个。
videoDurationsnumber[]有 videos 时必填参考视频时长秒数,必须与 videos 一一对应;每个时长分别向上取整到整秒后,按合计计费秒数 × 10 积分/秒计费。
audiosstring[]音频素材 URL 列表,最多 3 个。渠道接口直接透传素材,不做格式转换。
resolutionstring视频分辨率,支持 480p 或 720p。
aspectRatiostring输出比例,如 auto、1:1、9:16、16:9。
durationnumber视频时长,4-15 秒。
countnumber每组输入生成条数;最终子任务数会乘以 count。

请求示例

bash
curl -X POST "https://yunfanzhilian.com/api/third-party/videoGenerateChannel/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "用图片1的角色、图片2的场景,参考视频1的运镜和特效,再结合音频1的音色,生成一段新视频",
    "images": [
      "https://your-cdn.com/product-1.jpg",
      "https://your-cdn.com/product-2.jpg"
    ],
    "videos": [
      "https://your-cdn.com/reference-video.mp4"
    ],
    "videoDurations": [10],
    "audios": [],
    "resolution": "720p",
    "aspectRatio": "9:16",
    "duration": 10,
    "count": 1
  }'

响应字段

字段类型必填说明
codenumber-业务状态码,200 表示请求成功。
messagestring-本次请求的结果说明。
data.taskIdstring-任务 ID。提交成功后请保存,用于查询生成结果。
data.costnumber-本次提交预扣积分。
data.statusstring-任务初始状态,通常为 pending 或 processing。
timestampstring-响应时间,ISO 8601 格式。

响应示例

json
{
  "code": 200,
  "message": "渠道视频生成任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "pending",
    "mode": "video",
    "provider": "souldream-runmux",
    "model": "seedance-2.0",
    "totalTasks": 1,
    "submittedTasks": 1,
    "failedSubmissions": 0,
    "resolution": "720P",
    "aspectRatio": "9:16",
    "duration": 10,
    "cost": 200
  },
  "timestamp": "2026-03-31T09:33:00.000Z"
}

注意事项

  • 三个 Seedance 模型均通过 SOULDREAM RunMux 渠道提交,不复用视频生成(官方)的火山方舟调用链。
  • 扣分规则与视频生成(官方)完全一致;提交失败或任务失败会按原任务积分退款。
  • 渠道接口不处理图片、视频或音频素材,也不对生成结果做转码、水印或资源转存。
  • 提交成功后使用返回的 taskId 调用渠道结果接口,每 20 秒轮询一次,直到 completed 或 failed。