Hailuo-02

海螺旗舰版视频生成,支持文生视频、图生视频、关键帧模式和镜头运动指令,512P-1080P。

该模型已下线:CokeAPI 当前价目表中已不再提供 MiniMax-Hailuo-02,调用会返回模型不存在错误。请迁移到 Seedance 2。本页仅作历史参考。

CokeAPI 接入海螺 Hailuo-02 视频模型。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 succeeded。

图生视频提示:生成接口不再接收内联 base64 图片数据。请先使用文件上传接口上传参考图片获取 URL,再传入 image / images。

模型 ID: MiniMax-Hailuo-02

调用示例

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "[zoom in] 一只橘猫在雪地中奔跑,电影级画面,超高清",
    "aspect_ratio": "16:9",
    "quality": "hd",
    "duration": 6
  }'

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "镜头缓慢推进,主体转身面向镜头",
    "image": "https://cdn.cokeapi.com/uploads/2026/05/17/photo.png",
    "aspect_ratio": "16:9",
    "quality": "hd",
    "duration": 6
  }'

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "人物从左侧走向右侧,背景渐变",
    "image": "https://cdn.cokeapi.com/uploads/2026/05/17/first.png",
    "last_frame_image": "https://cdn.cokeapi.com/uploads/2026/05/17/last.png",
    "aspect_ratio": "16:9",
    "quality": "hd",
    "duration": 6
  }'

TASK_ID="01HX..."
curl https://cokeapi.com/v1/generations/$TASK_ID \
  -H "Authorization: Bearer sk-xxxxxxxx"

import httpx, time

BASE = "https://cokeapi.com/v1"
HEADERS = {"Authorization": "Bearer sk-xxxxxxxx"}

r = httpx.post(
    f"{BASE}/video/generations",
    headers=HEADERS,
    json={
        "model": "MiniMax-Hailuo-02",
        "prompt": "[zoom in] 一只橘猫在雪地中奔跑,电影级画面",
        "aspect_ratio": "16:9",
        "quality": "hd",
        "duration": 6,
    },
    timeout=60,
)
task_id = r.json()["id"]

while True:
    r = httpx.get(f"{BASE}/generations/{task_id}", headers=HEADERS, timeout=30)
    data = r.json()
    if data["status"] in ("succeeded", "failed", "refunded"):
        print(data)
        break
    time.sleep(5)

const BASE = "https://cokeapi.com/v1";
const KEY = process.env.COKEAPI_KEY;

const create = await fetch(`${BASE}/video/generations`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-02",
    prompt: "[zoom in] 一只橘猫在雪地中奔跑,电影级画面",
    aspect_ratio: "16:9",
    quality: "hd",
    duration: 6,
  }),
});
const { id: taskId } = await create.json();

while (true) {
  const poll = await fetch(`${BASE}/generations/${taskId}`, {
    headers: { "Authorization": `Bearer ${KEY}` },
  });
  const data = await poll.json();
  if (["succeeded", "failed", "refunded"].includes(data.status)) {
    console.log(data);
    break;
  }
  await new Promise((r) => setTimeout(r, 5000));
}

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	`MiniMax-Hailuo-02`
prompt	string	是	—	描述文本,支持镜头运动指令如 `[zoom in]` `[pan left]`
aspect_ratio	string	否	16:9	`16:9` / `9:16` / `1:1`
quality	string	否	standard	`sd`(512P) / `standard`(768P) / `hd`(1080P)
duration	int	否	6	时长秒数: `6` 或 `10`;1080P 仅支持 6 秒
image	string	否	—	单张参考图 URL (首帧驱动)
last_frame_image	string	否	—	尾帧图片 URL,配合 `image` 实现关键帧模式
prompt_optimizer	bool	否	true	是否启用提示词优化
aigc_watermark	bool	否	false	是否添加 AIGC 水印
seed	int	否	—	随机种子,可复现结果
async	bool	否	true	是否立即返回任务态
callback_url	string	否	—	任务完成时 POST 回调到此 URL

镜头运动指令

在 prompt 中插入以下指令可控制镜头运动:

[zoom in] [zoom out] [pan left] [pan right] [tilt up] [tilt down] [truck left] [truck right]

响应

创建任务 (`POST`)

{
  "id": "01HX...",
  "task_id": "01HX...",
  "object": "video.generation.task",
  "status": "queued",
  "progress": 0,
  "model": "MiniMax-Hailuo-02",
  "kind": "video",
  "mode": "text_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-02",
  "kind": "video",
  "mode": "text_to_video",
  "created": 1714200000
}

完成后:

{
  "id": "01HX...",
  "task_id": "01HX...",
  "object": "video.generation.task",
  "status": "succeeded",
  "progress": 100,
  "model": "MiniMax-Hailuo-02",
  "kind": "video",
  "mode": "text_to_video",
  "result": {
    "id": "01HX...",
    "object": "video.generation",
    "created": 1714200000,
    "model": "MiniMax-Hailuo-02",
    "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。
图生视频请先上传参考图 URL,再通过 image 传入。
关键帧模式需同时传入 image（首帧）和 last_frame_image（尾帧）。
1080P 分辨率下仅支持 6 秒时长。
失败的任务不计费,会自动返还预扣点数。

本页目录