Image-to-Video Task

Model name. Supported values: MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01.

Text description of the video, up to 2000 characters. For MiniMax-Hailuo-02 and I2V-01-Director models, camera movement can be controlled using [command] syntax.

• Supported 15 camera commands:

  • Truck: [Truck left], [Truck right]
  • Pan: [Pan left], [Pan right]
  • Push: [Push in], [Pull out]
  • Pedestal: [Pedestal up], [Pedestal down]
  • Tilt: [Tilt up], [Tilt down]
  • Zoom: [Zoom in], [Zoom out]
  • Shake: [Shake]
  • Follow: [Tracking shot]
  • Static: [Static shot]

• Usage rules:

  • Combined movements: Multiple commands inside one [] take effect simultaneously (e.g., [Pan left,Pedestal up]). Recommended max: 3.
  • Sequential movements: Commands appear in order, e.g., "...[Push in], then...[Push out]".
  • Natural language: Free-form descriptions also work, but explicit commands yield more accurate results.
  • For tutorials and templates, see Camera Movement Guide.

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

Reduces optimization time when prompt_optimizer is enabled. Defaults to false. Applies only to MiniMax-Hailuo-02.

Video duration (seconds). Default is 6. Supported values depend on the model and resolution:

Notes: The default resolution for other models is 720p.

Video resolution. Options depend on model and duration:

Specify an image as the starting frame of the video. Supports public URLs or Base64-encoded Data URLs (data:image/jpeg;base64,...).

• Required when:

  • model is I2V-01, I2V-01-Director, or I2V-01-live.
  • model is MiniMax-Hailuo-02 and resolution is 512P.

• Image requirements:

  • Formats: JPG, JPEG, PNG, WebP
  • Size: Less than 20MB
  • Dimensions: Short edge > 300px; aspect ratio between 2:5 and 5:2

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

from fastapi import FastAPI, HTTPException, Request
import json

app = FastAPI()

@app.post("/get_callback")
async def get_callback(request: Request):
    try:
        json_data = await request.json()
        challenge = json_data.get("challenge")
        if challenge is not None:
            # Validation request, echo back challenge
            return {"challenge": challenge}
        else:
            # Status update request, handle accordingly
            # {
            #     "task_id": "115334141465231360",
            #     "status": "success",
            #     "file_id": "205258526306433",
            #     "base_resp": {
            #         "status_code": 0,
            #         "status_msg": "success"
            #     }
            # }
            return {"status": "success"}
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(
        app,  # Required
        host="0.0.0.0",  # Required
        port=8000,  # Required, port can be customized
        # ssl_keyfile="yourname.yourDomainName.com.key",  # Optional, enable if using SSL
        # ssl_certfile="yourname.yourDomainName.com.key",  # Optional, enable if using SSL
    )

The video generation task ID, used for querying status.