Hailuo Pro

ID：hailuo/hailuo-pro

MiniMax 推出的 Hailuo Pro 视频生成 API —— 快速文生视频和图生视频，运动质量出色，角色一致性强。

文生视频图生视频

概览

MiniMax 推出的 Hailuo Pro 视频生成 API —— 快速文生视频和图生视频，运动质量出色，角色一致性强。

认证

所有 API 请求需要通过 Authorization 请求头以 Bearer 方式传递有效的 API 密钥。

快速开始

凭证

设置 RUNBASE_API_KEY 环境变量。

Shell

export RUNBASE_API_KEY=your-api-key

创建运行

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo/hailuo-pro",
    "input": {
      "prompt": "一张陶瓷台灯的电影级产品照片"
    }
  }'

运行记录

运行以异步方式处理。提交请求后，轮询获取结果。

创建运行

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo/hailuo-pro",
    "input": { "prompt": "一张陶瓷台灯的电影级产品照片" }
  }'

获取运行状态

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

获取结果

轮询状态接口，直到 status 为 "succeeded"，然后从响应中读取 output.urls。

输入 Schema

参数	类型	必填	描述
prompt	string	必填	Prompt最多 1500 个字符
image_urls	string[]	可选	Source image最多 1 张图片

输出 Schema

字段	类型	描述
urls	string[]	生成的输出 URL

错误

API 使用标准 HTTP 状态码表示成功或失败。

状态码	描述
400	잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401	인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402	크레딧 부족
403	접근 거부 - IP가 허용되지 않았거나, 계정이 차단되었거나, API 키 지출 한도 초과
404	실행을 찾을 수 없습니다
429	요청 속도 제한 초과
500	내부 서버 오류