跳转到主要内容
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-02",
    "prompt": "夕阳下海边的灯塔",
    "duration": 5
}'

{
    "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-02",
    "prompt": "夕阳下海边的灯塔",
    "duration": 5
}'

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

​
认证方式

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

​
请求参数

​
model
string
必填
模型名称，固定为 MiniMax-Hailuo-02
​
prompt
string
必填
视频生成的提示词。
​
duration
integer
默认值:"5"
视频时长。可选值：5 或 10。
​
resolution
string
视频分辨率。支持多种比例。
​
image_urls
array
图片输入。支持提供首帧图片或首尾帧图片链接。
​
prompt_optimizer
boolean
默认值:"true"
是否开启提示词优化器。
​
watermark
boolean
默认值:"false"
是否在生成的视频中包含水印。

​
响应参数

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

​
使用示例

图生视频示例 
{
    "model": "MiniMax-Hailuo-02",
    "prompt": "夕阳下海边的灯塔",
    "image_urls": ["https://example.com/lighthouse.jpg"],
    "duration": 5
}

​
注意事项

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