首页/开放能力
videoGenerateChannel

视频生成(渠道)

支持 RunMux Seedance 2.0、Fast、Mini(480P/720P),支持文生视频、9 图 + 3 视频 + 3 音频参考及 720P 超分;MiniMax H3 使用章鱼渠道(480P/768P),不使用超分参数。

MiniMax H3 480P 0.5积分/秒、768P 0.65积分/秒;Seedance 2.0 / Fast / Mini:480P 5/4/3积分/秒,原生 720P 10/8/6积分/秒,超分 720P 8/6/5积分/秒

基础说明

支持 RunMux Seedance 2.0、Fast、Mini(480P/720P),支持文生视频、9 图 + 3 视频 + 3 音频参考及 720P 超分;MiniMax H3 使用章鱼渠道(480P/768P),不使用超分参数。

提交任务

提交 Seedance 2.0 / Fast / Mini 或 MiniMax H3 渠道视频生成任务。

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(480P/720P)及 minimax-h3(480P/768P);默认 seedance-2.0-fast。
promptstring是视频生成提示词,描述镜头、动作、主体、背景与风格。Seedance 最多 8192 字节。
imagesstring[]否图片素材 URL 列表,最多 9 张;H3 的图片、视频和音频合计最多 9 项,第 6 张参考图起额外计费。
videosstring[]否Seedance 最多 3 个参考视频,总时长不超过 15 秒;H3 与图片和音频合计最多 9 项。
videoDurationsnumber[]有 videos 时必填参考视频时长秒数,必须与 videos 一一对应;Seedance 每段向上取整后按合计秒数 × 10 积分计费,H3 按实际时长加入总计费秒数。
audiosstring[]否Seedance 最多 3 个音频,必须与图片或视频共同提交;H3 与图片和视频合计最多 9 项。素材使用 HTTPS 直链。
resolutionstring否Seedance 支持 480p/720p,默认 720p;H3 支持 480p/768p,默认 768p。
upscaleboolean否720P 超分,仅适用于 Seedance 2.0 / Fast / Mini。默认 true:resolution=720p 且系统超分开关开启时,先生成 480P 再超分至 720P;false 使用原生 720P。系统超分开关关闭时使用原生 720P。480P 请求及 MiniMax H3 均忽略此参数。
aspectRatiostring否支持 21:9、16:9、4:3、1:1、3:4、9:16;Seedance 的 auto 映射为 adaptive,H3 的 auto/adaptive 映射为 9:16。
durationnumber否生成时长为 4-15 秒整数;H3 上游映射为字符串 seconds,aspectRatio 映射为 aspect_ratio。
countnumber否每组输入生成条数;最终子任务数会乘以 count。
watermarkboolean否Seedance 是否添加水印,默认 false。

请求示例

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": "minimax-h3",
    "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": "768p",
    "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": "zhangyu",
    "model": "minimax-h3",
    "totalTasks": 1,
    "submittedTasks": 1,
    "failedSubmissions": 0,
    "resolution": "768P",
    "aspectRatio": "9:16",
    "duration": 10,
    "cost": 13
  },
  "timestamp": "2026-03-31T09:33:00.000Z"
}

注意事项

  • Seedance 2.0、Fast、Mini 均通过 RunMux Ark 接口提交与查询,provider=runmux;支持纯文本及图片、视频、音频参考素材,常规入参与官方入口保持一致。
  • Seedance 使用 HTTPS 素材直链,不支持 asset://、账号密码或 fragment。
  • upscale 仅适用于 Seedance 的 720P 请求,默认 true 并遵循系统超分开关;实际开启时先生成 480P 再超分至 720P,传 false 使用原生 720P。MiniMax H3 不使用此参数,传入也不会生效。
  • Seedance 480P 分别为 5/4/3 积分每秒;原生 720P 分别为 10/8/6 积分每秒;开启超分时 720P 分别为 8/6/5 积分每秒。参考视频每段向上取整后按 10 积分每秒另计。
  • Seedance 每个子任务先保存请求与幂等键再提交;提交超时后查询原 taskId 恢复,不重复扣费;明确失败退款。
  • Seedance 请求示例:{"model":"seedance-2.0-fast","prompt":"产品缓慢旋转","resolution":"720p","duration":5,"upscale":true,"watermark":false};如需原生 720P,将 upscale 改为 false。
  • MiniMax H3 总计费秒数 = 生成时长 + 各参考视频实际时长;480P 0.5 积分/秒、768P 0.65 积分/秒,第 6 张参考图起每张加 3 积分。例如生成 10 秒并引用 10 秒视频,768P 为 (10 + 10) × 0.65 = 13 积分。
  • H3 使用章鱼渠道,返回 provider=zhangyu,不自动转火山官方,fallbackToOfficial 为 false;未配置时在扣费前拒绝,失败时退款。
  • H3 使用 ZHANGYU_API_KEY,提交和查询地址为 https://zexapi.com/v1/videos,单次请求超时为 18 分钟;提交不自动重试,历史 RunMux H3 任务仍查询原渠道。
  • 提交成功后使用返回的 taskId 调用渠道结果接口,每 20 秒轮询一次,直到 completed 或 failed。