Skip to main content
POST
/
v1
/
videos
Hailuo Subject Reference Video
curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-Hailuo-2.3",
  "subject_reference": [
    "https://example.com/assets/character.png"
  ],
  "prompt": "The character waves and smiles",
  "seconds": "6",
  "size": "720P"
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "status": "queued",
  "progress": 0,
  "created_at": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
model
enum<string>
required

Model name used for this capability.

Available options:
MiniMax-Hailuo-2.3,
MiniMax-Hailuo-2.3-Fast,
MiniMax-Hailuo-02
​
subject_reference
string[]
required

Array of subject reference image URLs for maintaining visual consistency.

Minimum array length: 1
​
prompt
string
required

Video prompt describing the action or scene.

​
seconds
string

Target video duration in seconds.

​
size
string

Target output size or resolution. Available values depend on the selected model.

Response

Submission successful, returns unified OpenAI-style video task object.

​
id
string
​
task_id
string
​
object
string
Example:

"video"

​
model
string
​
status
string
Example:

"queued"

​
progress
integer
Example:

0

​
created_at
integer<int64>