跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
videos
/
generations
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只可爱的小猫在草地上奔跑 [推进]",
    "resolution": "768p",
    "duration": 6
}'

{
    "code": "success",
    "data": "task-wave1741000000000123456789"
}
本接口为异步调用。任务成功提交后会返回 task_id，您需要通过 查询任务状态 接口获取最终的生成结果。生成后的文件链接有效期为 24 小时。
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只可爱的小猫在草地上奔跑 [推进]",
    "resolution": "768p",
    "duration": 6
}'

{
    "code": "success",
    "data": "task-wave1741000000000123456789"
}

​
认证方式

在请求头中使用 API Key 进行身份验证。您可以在 API Key 管理 页面获取您的密钥。 
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
必填
模型名称，固定为 MiniMax-Hailuo-2.3
​
prompt
string
必填
视频生成的提示词。支持使用 [命令] 语法控制运镜。
​
duration
integer
默认值:"6"
视频时长。可选值：6 或 10。注意 1080p 分辨率下仅支持 6 秒时长。
​
resolution
string
默认值:"768p"
视频分辨率。
  • 768p: 1344x768 (横屏) / 768x1344 (竖屏)
  • 1080p: 1920x1080 (横屏) / 1080x1920 (竖屏)
​
first_frame_image
string
首帧图片。支持 URL 或 Base64 编码字符串。提供此参数后，模型将基于该图片生成视频。
​
prompt_optimizer
boolean
默认值:"true"
是否开启提示词优化器。
​
fast_pretreatment
boolean
默认值:"false"
是否开启快速预处理。
​
watermark
boolean
默认值:"false"
是否在生成的视频中包含水印。

​
分辨率与时长矩阵

分辨率时长 (s)备注
768p6 / 10默认分辨率
1080p6高清模式

​
运镜控制命令

您可以在 prompt 中加入以下命令来精确控制相机移动：
命令说明命令说明
[左移]相机向左移动[右移]相机向右移动
[左摇]相机向左水平旋转[右摇]相机向右水平旋转
[推进]相机向前推进[拉远]相机向后拉远
[上升]相机向上提升[下降]相机向下降低
[上摇]相机向上垂直旋转[下摇]相机向下垂直旋转
[变焦推近]镜头光学变焦放大[变焦拉远]镜头光学变焦缩小
[晃动]相机随机晃动[跟随]相机跟随主体移动
[固定]固定机位

​
响应参数

​
code
string
响应状态码 * success - 请求成功，任务已提交
​
data
string
任务 ID，格式为 task-wave{timestamp}{userId}{random}，用于通过 查询任务状态 接口获取生成结果

​
使用示例

图生视频示例 
{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只可爱的小猫在草地上奔跑",
    "first_frame_image": "https://example.com/cat.jpg",
    "duration": 6
}

​
注意事项

  1. 异步处理: 视频生成通常需要数分钟。请记录返回的 data (任务 ID) 并轮询状态接口。
  2. 错误处理:
    • invalid_request: 请求参数无效。
    • authentication_error: 身份验证失败，请检查您的 API 密钥。
    • payment_required: 账户余额不足，请充值后再试。
    • quota_not_enough: 用户额度不足。
    • rate_limit_error: 请求过于频繁，请稍后再试。
    • server_error: 服务器内部错误，请稍后重试。
  3. 参数限制: 1080p 不支持 10 秒时长，请求时请务必注意参数组合。