支持 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-Token | string | 是 | 平台提供的调用凭证,用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 支持 seedance-2.0、seedance-2.0-fast、seedance-2.0-mini(480P/720P)及 minimax-h3(480P/768P);默认 seedance-2.0-fast。 |
| prompt | string | 是 | 视频生成提示词,描述镜头、动作、主体、背景与风格。Seedance 最多 8192 字节。 |
| images | string[] | 否 | 图片素材 URL 列表,最多 9 张;H3 的图片、视频和音频合计最多 9 项,第 6 张参考图起额外计费。 |
| videos | string[] | 否 | Seedance 最多 3 个参考视频,总时长不超过 15 秒;H3 与图片和音频合计最多 9 项。 |
| videoDurations | number[] | 有 videos 时必填 | 参考视频时长秒数,必须与 videos 一一对应;Seedance 每段向上取整后按合计秒数 × 10 积分计费,H3 按实际时长加入总计费秒数。 |
| audios | string[] | 否 | Seedance 最多 3 个音频,必须与图片或视频共同提交;H3 与图片和视频合计最多 9 项。素材使用 HTTPS 直链。 |
| resolution | string | 否 | Seedance 支持 480p/720p,默认 720p;H3 支持 480p/768p,默认 768p。 |
| upscale | boolean | 否 | 720P 超分,仅适用于 Seedance 2.0 / Fast / Mini。默认 true:resolution=720p 且系统超分开关开启时,先生成 480P 再超分至 720P;false 使用原生 720P。系统超分开关关闭时使用原生 720P。480P 请求及 MiniMax H3 均忽略此参数。 |
| aspectRatio | string | 否 | 支持 21:9、16:9、4:3、1:1、3:4、9:16;Seedance 的 auto 映射为 adaptive,H3 的 auto/adaptive 映射为 9:16。 |
| duration | number | 否 | 生成时长为 4-15 秒整数;H3 上游映射为字符串 seconds,aspectRatio 映射为 aspect_ratio。 |
| count | number | 否 | 每组输入生成条数;最终子任务数会乘以 count。 |
| watermark | boolean | 否 | 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
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码,200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存,用于查询生成结果。 |
| data.cost | number | - | 本次提交预扣积分。 |
| data.status | string | - | 任务初始状态,通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间,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。
