Skip to main content
POST
Video Generation

Authorizations

Authorization
string
header
required

HTTP: Bearer Auth

Headers

Content-Type
enum<string>
default:application/json
required

The media type of the request body. Must be set to application/json to ensure the data is sent in JSON format.

Available options:
application/json

Body

application/json
model
enum<string>
required

Model name. Supported values: S2V-01.

Available options:
S2V-01
subject_reference
object[]
required

Subject reference images

prompt
string

Text description of the video, up to 2000 characters.

prompt_optimizer
boolean

Whether to automatically optimize the prompt. Defaults to true. Set to false for more precise control.

callback_url
string

A callback URL to receive asynchronous task status updates.

  1. Validation: Once configured, MiniMax sends a POST request with a challenge field. Your server must echo this value within 3s to validate.
  2. Updates: After validation, MiniMax pushes status updates when the task changes. Response structure matches the Query Video Generation Task API.

Callback status values:

  • "processing" – Task in progress
  • "success" – Task completed successfully
  • "failed" – Task failed

Response

200 - application/json
task_id
string

The video generation task ID, used for querying status.

base_resp
object