Hailuo Pro

ID:hailuo/hailuo-pro

Hailuo Pro video generation API by MiniMax — fast text-to-video and image-to-video with strong motion quality and character consistency.

Text to videoImage to video

Overview

Hailuo Pro video generation API by MiniMax — fast text-to-video and image-to-video with strong motion quality and character consistency.

Authentication

All API requests require a valid API key passed via the Authorization header using the Bearer scheme.

Quickstart

Credentials

Set the RUNBASE_API_KEY environment variable.

Shell

export RUNBASE_API_KEY=your-api-key

Create a run

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": "A cinematic product photo of a ceramic lamp"
    }
  }'

Runs

Runs are processed asynchronously. Submit a request, then poll for the result.

Create a run

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": "A cinematic product photo of a ceramic lamp" }
  }'

Get run status

Shell

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

Get result

Poll the status endpoint until status is "succeeded", then read output.urls from the response.

Input Schema

Parameter	Type	Required	Description
prompt	string	Required	PromptUp to 1500 characters
image_urls	string[]	Optional	Source imageUp to 1 images

Output Schema

Field	Type	Description
urls	string[]	Generated output URLs

Errors

The API uses standard HTTP status codes to indicate success or failure.

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