Back to Details

hailuo-video

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Hailuo Video Generation

Hailuo视频生成

Generate AI videos through AceDataCloud's Hailuo (MiniMax) API.
Setup: See authentication for token setup.
通过AceDataCloud的Hailuo（MiniMax）API生成AI视频。
设置： 请查看身份验证了解令牌设置。

Quick Start

快速开始

bash
curl -X POST https://api.acedata.cloud/hailuo/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "minimax-t2v"}'
Async: See async task polling. Poll via 
POST /hailuo/tasks
with 
{"id": "..."}
.
bash
curl -X POST https://api.acedata.cloud/hailuo/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "黄昏时分海豚跃过海浪", "model": "minimax-t2v"}'
异步处理： 请查看异步任务轮询。通过
POST /hailuo/tasks
并携带
{"id": "..."}
进行轮询。

Models

模型

ModelTypeBest For
minimax-t2v
Text-to-VideoCreating video from text description
minimax-i2v
Image-to-VideoAnimating a still image
minimax-i2v-director
Image-to-Video (Director)Precise control over animation from image
模型类型适用场景
minimax-t2v
文本转视频根据文本描述创建视频
minimax-i2v
图片转视频将静态图片动效化
minimax-i2v-director
图片转视频（导演模式）对图片动效实现精准控制

Workflows

工作流程

1. Text-to-Video

1. 文本转视频

json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "a time-lapse of flowers blooming in a meadow",
  "model": "minimax-t2v"
}
json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "草地上花朵绽放的延时摄影",
  "model": "minimax-t2v"
}

2. Image-to-Video

2. 图片转视频

Animate a still image into a video clip.
json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "gentle wind blows through the scene",
  "model": "minimax-i2v",
  "first_image_url": "https://example.com/landscape.jpg"
}
将静态图片转换为视频片段。
json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "微风吹过场景",
  "model": "minimax-i2v",
  "first_image_url": "https://example.com/landscape.jpg"
}

3. Image-to-Video (Director Mode)

3. 图片转视频（导演模式）

More precise control over the animation.
json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "camera slowly zooms in while leaves fall gently",
  "model": "minimax-i2v-director",
  "first_image_url": "https://example.com/scene.jpg"
}
对动效实现更精准的控制。
json
POST /hailuo/videos
{
  "action": "generate",
  "prompt": "镜头缓慢拉近，树叶轻轻飘落",
  "model": "minimax-i2v-director",
  "first_image_url": "https://example.com/scene.jpg"
}

Parameters

参数说明

ParameterRequiredValuesDescription
action
Yes
"generate"
Action type
prompt
YesstringVideo description
model
Yes
"minimax-t2v"
, 
"minimax-i2v"
, 
"minimax-i2v-director"
Model
first_image_url
For i2vstringSource image URL (required for image-to-video)
callback_url
NostringAsync callback URL
参数是否必填取值描述
action
是
"generate"
操作类型
prompt
是字符串视频描述
model
是
"minimax-t2v"
, 
"minimax-i2v"
, 
"minimax-i2v-director"
模型
first_image_url
图片转视频必填字符串源图片URL（图片转视频时必填）
callback_url
否字符串异步回调URL

Gotchas

注意事项

  • first_image_url
    is required for 
    minimax-i2v
    and 
    minimax-i2v-director
    models
  • Director mode (
    minimax-i2v-director
    ) provides finer camera/motion control than standard i2v
  • The 
    action
    field currently only supports 
    "generate"
    — no extend or edit
  • Flat pricing per generation regardless of model
  • 使用
    minimax-i2v
    和
    minimax-i2v-director
    模型时，
    first_image_url
    为必填项
  • 导演模式（
    minimax-i2v-director
    ）比普通图片转视频模式提供更精细的镜头/动效控制
  • 当前
    action
    字段仅支持
    "generate"
    ，暂不支持扩展或编辑操作
  • 无论使用哪种模型，每次生成均采用统一定价