MiniMax · Video

Image to VideoNEW

📌 What is this：Generate a moving video from reference images.

💡 When to use：Use when you have reference images to animate (up to 9).

🔗 Response format：The query response follows the OpenAI video-task format: a flat top-level structure (no {code,msg,data} wrapper), lowercase status queued / running / success / failed, success returns video_url, failure returns {"error":{"code","message"}}; video_url is our CDN direct link, ready to download/play.

Endpoints

Usage	Method	Path
Submit task	POST	/v1/videos
Query Result	GET	/v1/videos/{taskId}

⏱ Recommended polling interval：Poll GET /v1/videos/{taskId} every 5s until status = success / failed.

Request Parameters

Param	Type	Required	Description
model	string	—	Fixed minimax-h3
prompt	string	Required	Required — image-to-video must also include a prompt (new engine), e.g. "gentle camera push-in, soft light"
image_urls	string[]	Required	Reference image URLs, up to 9 (alias: images)
ratio	string	—	Aspect ratio, 1 of 8: 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9, default 16:9 (each maps to a fixed resolution; see the size table; resolution auto-selected, no extra charge)
duration	integer	—	Duration (sec) integer 4-15, default 4 (alias: seconds)

Request Example

curl -X POST https://api.cqtai.com/v1/videos \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "minimax-h3",
    "prompt": "gentle camera push-in, soft light",
    "image_urls": ["https://cdn.novapi.ai/your/frame.png"],
    "ratio": "9:16",
    "duration": 8
  }'
# -> 创建响应: { "id":"<task_id>", "task_id":"<task_id>", "object":"video", "model":"minimax-h3", "status":"PROCESSING", "progress":0 }

Response Example

{
  "id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "task_id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "object": "video",
  "model": "minimax-h3",
  "status": "success",
  "progress": 100,
  "video_url": "https://cdn.novapi.ai/minimax/1786516943631_d6ddaeaa68a4464f9e16938f16b9534b.mp4"
}

Response Fields

Field	Type	Description
id	string	Task ID (opaque), same as task_id; used to poll GET /v1/videos/{task_id}
task_id	string	Task ID (opaque); returned on submit, used for polling
object	string	Object type, always "video"
model	string	Model name, always "minimax-h3"
status	string	Task status (lowercase): queued / running / success / failed
progress	number	Progress 0-100
video_url	string	Result video URL (our CDN direct link); returned when status = success
error	object	Error info {"code","message"}; returned when status = failed

Billing & Credits

15 credits x duration (sec), 4-15s (x your user rate). Auto-refunded on failure.