Quotaflow
llms.txtOpenAPIDashboard
Model Library

MiniMax H3 — video API

Use minimax/h3 for MiniMax H3 text-to-video, video from a first frame or from a first and last frame, and video from reference images, at 768p or 2K, through the Quotaflow /openai/v1/videos task API: create a task, store the returned id, and poll until the task completes. It uses the same API as the other video models; compare them on the Videos page.

MiniMax H3, Kling, Wan, Seedance, and Veo are different video model families. minimax/h3 is never used as a fallback for another family's model, and no other model stands in for it.

Model contract

PropertyValue
Model idminimax/h3, as /models lists it
EndpointPOST https://api.quotaflow.ai/openai/v1/videos
Status endpointGET https://api.quotaflow.ai/openai/v1/videos/{task_id}
Content endpointGET https://api.quotaflow.ai/openai/v1/videos/{task_id}/content
durationSeconds4–15; default 5
resolution768p or 2k; default 768p
aspect_ratiotext_to_video: 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16; default 16:9. image_reference: the same, or adaptive (the default). Frame modes: ignored, the frame decides
Modestext_to_video (the default), image_to_video, first_last_frame, image_reference
first_frame_url, last_frame_urlPublic https:// image links
reference_image_urls1–9 public https:// image links
max_cost_usdRequired

Call /models with your production key before launch. Video access is key-enabled: the default all-model key has it. Only a key with access to the MiniMax H3 video line lists minimax/h3.

Prices

Prices are USD per second of video, by the output resolution. Every mode is charged at the same rate. The seconds charged are the input video seconds plus the output video seconds.

Unit2k768p
Video, per second (input plus output)$0.13$0.08
Input image beyond the first 5 per task, each$0.04$0.04

The first 5 input images of a task (frames and reference images together) are free; each further one is $0.04 at either resolution. The max_cost_usd hold taken when the task is created is separate from the final charge.

Text-to-video example

curl https://api.quotaflow.ai/openai/v1/videos \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3",
    "prompt": "A paper boat drifting across a still pond at sunrise, slow camera pan.",
    "durationSeconds": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9",
    "max_cost_usd": 2
  }'

First-frame example

Set mode to image_to_video and send first_frame_url. For first_last_frame, also send last_frame_url. Frames are public https:// links; a Base64 data URL is refused. The video takes its shape from the frame, so aspect_ratio is ignored with a frame.

curl https://api.quotaflow.ai/openai/v1/videos \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3",
    "mode": "image_to_video",
    "prompt": "Keep the product shape and color consistent, slow camera push-in.",
    "first_frame_url": "https://example.com/frames/product.png",
    "durationSeconds": 5,
    "resolution": "768p",
    "max_cost_usd": 2
  }'

Reference-image example

Set mode to image_reference and send up to 9 public https:// image links in reference_image_urls, with no frames.

curl https://api.quotaflow.ai/openai/v1/videos \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3",
    "mode": "image_reference",
    "prompt": "The character from the references walks through a rainy street at night.",
    "reference_image_urls": ["https://example.com/refs/character-front.png", "https://example.com/refs/character-side.png"],
    "durationSeconds": 5,
    "resolution": "768p",
    "max_cost_usd": 2
  }'

Poll the task

curl https://api.quotaflow.ai/openai/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY"

Download the completed video

curl -L https://api.quotaflow.ai/openai/v1/videos/$TASK_ID/content \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  --output h3.mp4

The content endpoint redirects to the video file; add ?format=json to receive { "url", "expires_at" } instead.

Notes

Next steps