MiniMax · Video

First/Last Frame VideoNEW

📌 What is this：Given a first frame (optionally a last frame too), generate a video that starts from the first frame and transitions toward the last: the opening frame ≈ first_image, the closing frame ≈ last_image, with a smooth transition in between.

💡 When to use：Use to precisely control the opening frame; add a last frame to also control the ending and produce a transition. Note: first/last-frame mode is mutually exclusive with image_urls / audio_urls / reference_videos — you cannot also pass reference images, audio or reference video; max duration is 10 seconds.

🔗 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
workflow_id	string	—	Workflow; this page uses fl2v (omit to infer from inputs: first_image->fl2v, image_urls->multi-reference, none->text-to-video; CF super-res / 4-image / flexible-multi-ref / MJ cannot be inferred and must be set explicitly)
prompt	string	Required	Required. Text description (the new engine always requires prompt — including image-to-video and first/last-frame, e.g. "gentle camera push-in, soft light")
first_image	string	Required	First-frame keyframe image URL (required, alias: first_frame_image); first-only pins the opening frame, the model free-runs the ending
last_image	string	—	Last-frame keyframe image URL (optional, alias: last_frame_image); must accompany first_image — passing last only returns invalid_request
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 (ratio x resolution tier determine the output size; see the size table)
resolution	string	—	Resolution tier (case-insensitive): 480P / 768P / 1080P, default 1080P; unit price varies by tier (480P=5, 768P=12, 1080P=18 credits/sec), see billing
duration	integer	—	Duration (sec) integer 4~10, default 4 (alias: seconds)
prompt_enhance	boolean	—	Prompt enhancement (optional, boolean); defaults to on if omitted

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",
    "workflow_id": "fl2v",
    "prompt": "smooth transition between the two frames",
    "first_image": "https://cdn.novapi.ai/your/first.png",
    "last_image": "https://cdn.novapi.ai/your/last.png",
    "ratio": "16:9",
    "resolution": "1080P",
    "duration": 6
  }'
# -> 创建响应: { "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

Billed per second = credits/sec x duration (sec). Credits/sec: 480P=5, 768P=12, 1080P=18. Example: 1080P 6s = 18 x 6 = 108. Auto-refunded on failure.