Model API

MiniMax (Hailuo AI) Video 01 Subject Reference

Generate video clips maintaining consistent, realistic facial features and identity across dynamic video content

Model id

Use this in every request

minimax/video-01-subject-reference

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/video-01-subject-reference",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "subject_reference_image_url": "https://example.com/input.png"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "minimax/video-01-subject-reference", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","subject_reference_image_url":"https://example.com/input.png"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for minimax/video-01-subject-reference
Name	Type	Description
`prompt`required	string	Prompt
`subject_reference_image_url`required	string (image URL)	URL of the subject reference image to use for consistent subject appearance
`prompt_optimizer`	boolean	Whether to use the model's prompt optimizer Default: `true`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Pricing

up to, default options$0.80/ run

The exact charge for your input comes from a quote. How charges settle