视频生成 (统一接口)

POST

/hailuo/v1/video_generation

海螺视频生成统一接口,支持多种生成模式

注意: 所有视频生成功能(文生视频、图生视频、首尾帧、主体参考)都使用同一个接口,通过不同的参数组合来实现不同功能。

支持的模型:

文生视频 (Text to Video)

MiniMax-Hailuo-02: 海螺02,支持512P/768P/1080P

MiniMax-Hailuo-2.3: 海螺2.3,支持768P/1080P

MiniMax-Hailuo-2.3-Fast: 海螺2.3快速版,支持768P/1080P

T2V-01-Director: 导演版,支持镜头控制

T2V-01: 基础版

图生视频 (Image to Video)

I2V-01-Director: 导演版

I2V-01-live: 实况版

I2V-01: 基础版

首尾帧生视频

所有 Hailuo 系列模型

主体参考生视频

S2V-01: 主体参考生视频模型

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

文生视频 (Text to Video)图生视频 (Image to Video)首尾帧生视频主体参考生视频

{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只可爱的小猫在阳光下玩耍,画面温馨治愈",
    "duration": 6,
    "resolution": "1080P",
    "prompt_optimizer": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生视频 (Text to Video)图生视频 (Image to Video)首尾帧生视频主体参考生视频

curl --location --request POST '/hailuo/v1/video_generation' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只可爱的小猫在阳光下玩耍,画面温馨治愈",
    "duration": 6,
    "resolution": "1080P",
    "prompt_optimizer": true
}'

返回响应

🟢200成功

application/json

任务创建成功

Body

示例

{
    "task_id": "task_1234567890abcdef",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

🟠400请求有误

🟠401没有权限

🔴500服务器错误

修改于 2025-11-20 01:16:15

查询积分余额

查询视频生成任务状态

视频生成 (统一接口)

支持的模型:#

文生视频 (Text to Video)#

图生视频 (Image to Video)#

首尾帧生视频#

主体参考生视频#