跳转到主要内容
POST
https://api.ppio.com
/
v3
/
async
/
minimax-hailuo-02
Minimax Hailuo-02
curl --request POST \
  --url https://api.ppio.com/v3/async/minimax-hailuo-02 \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "end_image": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "enable_prompt_expansion": true,
  "fast_pretreatment": true,
  "aigc_watermark": true
}
'
{
  "task_id": "<string>"
}
Minimax Hailuo-02 是一款支持文本生成视频和图片生成视频的AI视频生成模型。它可以生成 6秒的 768P 或 1080P 分辨率视频，以及 10秒的 768P 分辨率视频。
这是一个异步API，只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索视频生成结果。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
prompt
string
必填
指导生成所需的提示词文本。范围: 1 <= x <= 2000。
​
image
string
用于视频生成的首帧图片。支持公网 URL 或 Base64 编码（如 data:image/jpeg;base64,...）。
​
end_image
string
用于视频生成的结束帧图片。支持公网 URL 或 Base64 编码（如 data:image/jpeg;base64,...）。
​
duration
integer
生成视频的时长（秒）。默认值：6
可选值：6、10
​
resolution
string
生成视频的分辨率。默认值：768P
  • 6 秒视频支持：768P、1080P
  • 10 秒视频仅支持：768P
​
enable_prompt_expansion
boolean
是否启用提示词优化。默认值: true。
​
fast_pretreatment
boolean
默认值:false
是否缩短提示词优化的耗时。默认值: false。
​
aigc_watermark
boolean
默认值:false
为生成的视频添加水印。
  • false：不添加水印。
  • true：在视频添加文字的水印，标识由人工智能生成合成。

​
响应

​
task_id
string
必填
异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果

​
示例

以下是如何使用 Minimax Hailuo-02 API 的示例。
  1. 通过向 Minimax Hailuo-02 API 发送 POST 请求来生成 task_id。
请求: 
curl \
-X POST https://api.ppio.com/v3/async/minimax-hailuo-02 \
-H "Authorization: Bearer $your_api_key" \
-H "Content-Type: application/json" \
-d '{
  "image": "https://static.ppinfra.com/docs/assets/minimax-hailuo-video-02-input-image.jpg",
  "prompt": "戴着太阳镜的毛茸茸的熊猫在日出时的雪山顶上跳舞，左移运镜",
  "duration": 6,
  "resolution": "768P",
  "enable_prompt_expansion": true
}'
响应: 
{
    "task_id": "{返回的 Task ID}"
}
  1. 使用 task_id 获取输出视频。
2xx 范围内的 HTTP 状态码表示请求已成功接受，而 5xx 范围内的状态码表示内部服务器错误。 您可以在响应的 videos 字段中获取视频 url。 请求: 
curl --location --request GET 'https://api.ppio.com/v3/async/task-result?task_id={返回的 Task ID}' \
--header 'Authorization: Bearer {{API Key}}'
响应: 
{
    "task": {
        "task_id": "{返回的 Task ID}",
        "task_type": "MINIMAX_HAILUO_02",
        "status": "TASK_STATUS_SUCCEED",
        "reason": "",
        "eta": 0,
        "progress_percent": 100
    },
    "images": [],
    "videos": [
        {
            "video_url": "{生成视频的 URL}",
            "video_url_ttl": "3600",
            "video_type": "mp4"
        }
    ]
}
视频文件: