视频生成系列
Hailuo 2.3 Fast
海螺快速版视频生成,仅支持图生视频,768P-1080P,快速生成。
该模型已下线:CokeAPI 当前价目表中已不再提供 MiniMax-Hailuo-2.3-Fast,调用会返回模型不存在错误。请迁移到 Seedance 2。本页仅作历史参考。
CokeAPI 接入海螺 Hailuo 2.3 Fast 视频模型。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 succeeded。
图生视频提示:生成接口不再接收内联 base64 图片数据。请先使用 文件上传接口 上传参考图片获取 URL,再传入 image / images。
模型 ID: MiniMax-Hailuo-2.3-Fast
调用示例
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | MiniMax-Hailuo-2.3-Fast |
| prompt | string | 是 | — | 描述文本 |
| aspect_ratio | string | 否 | 16:9 | 16:9 / 9:16 / 1:1 |
| quality | string | 否 | standard | standard(768P) / hd(1080P) |
| duration | int | 否 | 6 | 时长秒数: 6 或 10;1080P 仅支持 6 秒 |
| image | string | 是 | — | 参考图 URL (仅支持图生视频) |
| seed | int | 否 | — | 随机种子,可复现结果 |
| async | bool | 否 | true | 是否立即返回任务态 |
| callback_url | string | 否 | — | 任务完成时 POST 回调到此 URL |
响应
创建任务 (POST)
{
"id": "01HX...",
"task_id": "01HX...",
"object": "video.generation.task",
"status": "queued",
"progress": 0,
"model": "MiniMax-Hailuo-2.3-Fast",
"kind": "video",
"mode": "image_to_video",
"created": 1714200000
}查询任务 (GET /v1/generations/{task_id})
进行中:
{
"id": "01HX...",
"task_id": "01HX...",
"object": "video.generation.task",
"status": "running",
"progress": 45,
"model": "MiniMax-Hailuo-2.3-Fast",
"kind": "video",
"mode": "image_to_video",
"created": 1714200000
}完成后:
{
"id": "01HX...",
"task_id": "01HX...",
"object": "video.generation.task",
"status": "succeeded",
"progress": 100,
"model": "MiniMax-Hailuo-2.3-Fast",
"kind": "video",
"mode": "image_to_video",
"result": {
"id": "01HX...",
"object": "video.generation",
"created": 1714200000,
"model": "MiniMax-Hailuo-2.3-Fast",
"data": [
{
"url": "https://cdn.cokeapi.com/v/01HX....mp4",
"duration_ms": 6000,
"width": 1920,
"height": 1080
}
]
},
"created": 1714200000
}Hailuo 任务平均耗时 60-180 秒。推荐每 5 秒轮询一次。也可以在创建时传 callback_url,任务完成后主动 POST 推送结果。超过 15 分钟仍未完成会自动标记为 failed 并退款。统一查询入口见 异步任务。
计费
按任务计费。
注意事项
- 任务最长保留 24 小时,超过会被清理。需要长期存储请下载到自有 OSS。
MiniMax-Hailuo-2.3-Fast仅支持图生视频模式,必须传入image参数。- 1080P 分辨率下仅支持 6 秒时长。
- 失败的任务不计费,会自动返还预扣点数。