跳转到主要内容
POST
/
v1
/
tasks
Hailuo 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "minimax-hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

MiniMax 海螺(Hailuo)视频生成系列。 两档可选 — minimax-hailuo-2.3(2.3 主版,新增 15 种运镜指令)、minimax-hailuo-2.3-fast(2.3 加速档,更快更便宜,适合预览/批量)。 支持文生视频(T2V)与图生视频(I2V)。

​
定价

按 分辨率 × 时长 计费,单位 $ / 秒。
模型768P1080P
minimax-hailuo-2.3$0.05185$0.0765
minimax-hailuo-2.3-fast$0.02635$0.04505

​
调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-hailuo-2.3",
    "prompt": "一只柴犬穿宇航服在月球上行走,电影感光影",
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "minimax-hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID分辨率时长(秒)Actions备注
minimax-hailuo-2.3768p / 1080p6 / 10generate / image2video1080p 仅 6 秒;15 种运镜指令;prompt ≤ 2000 字符
minimax-hailuo-2.3-fast768p / 1080p6 / 10generate / image2video加速档,单价更低

​
通用参数

​
model
string
必填
模型 ID,可选值:
  • minimax-hailuo-2.3
  • minimax-hailuo-2.3-fast
​
action
string
默认值:"generate"
操作类型,通常无需显式传(后端按媒体字段自动路由)。可选值:
  • generate — 文生视频(T2V)
  • image2video — 图生视频(I2V),需配合 image_urls
​
prompt
string
必填
视频描述文本,最多 2000 字符;在文中以 [指令] 中括号嵌入运镜标签可触发对应镜头运动(详见下方 运镜指令)
​
aspect_ratio
string
默认值:"16:9"
画面宽高比,可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 1:1 — 正方形
​
resolution
string
默认值:"768p"
输出分辨率,模型支持范围见 可用模型 表。可选值:
  • 768p
  • 1080p
​
duration
integer
视频时长(秒)。支持 6 / 10(1080p 仅 6)
​
image_urls
string[]
参考图片 URL 数组,触发 I2V 模式;支持公网 URL 或 Base64
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
订阅的回调事件类型,默认全部终态

​
模型特定参数

​
watermark
boolean
默认值:"false"
是否在输出视频上叠加 MiniMax 水印
​
prompt_optimizer
boolean
默认值:"true"
自动优化提示词;关闭后按原始 prompt 直接生成
​
fast_pretreatment
boolean
默认值:"false"
缩短 prompt 优化耗时
​
camera_movement_tags
string[]
运镜指令列表(共 15 种)。建议同时在 prompt 中以 [指令] 中括号嵌入,详见下方 运镜指令

​
运镜指令(2.3 / 2.3-fast)

Hailuo 2.3 系列独家亮点 — 在 prompt 中以 [指令] 中括号嵌入 即可触发对应镜头运动;同一句可叠加多个标签,后端会按顺序解析。也可同时通过 camera_movement_tags 字段显式传入,提升识别稳定性。
类别指令效果
位移[左移]镜头水平向左平移
[右移]镜头水平向右平移
[上升]镜头垂直向上抬升
[下降]镜头垂直向下落下
推拉[推进]镜头物理向前推进
[拉远]镜头物理向后拉远
摇镜[左摇]机身固定向左摇头
[右摇]机身固定向右摇头
[上摇]机身固定向上仰
[下摇]机身固定向下俯
变焦[变焦推近]焦距变化模拟推近(机身不动)
[变焦拉远]焦距变化模拟拉远(机身不动)
特殊[晃动]手持感抖动
[跟随]跟随主体运动
[固定]完全静止机位
写法示例 — "[推进] 古镇青石板路,[变焦推近] 雨水从屋檐滴落" —— 镜头先向前推,再聚焦屋檐细节。

​
资源限制

项目限制
参考图片(image_urls)URL 或 Base64,JPG/PNG/WEBP
Prompt 长度≤ 2000 字符
时长6 / 10 秒;1080p 仅 6 秒
输出MP4,链接 24 小时有效

​
相关文档