Reference to video with MiniMax H3
Produce a video from a text prompt and optional reference media with
MiniMax H3. Upload reference_images and reference_audios using
multipart/form-data, and address them in the prompt by position
(Image 1, Audio 1, …). Returns a generation_id; poll
GET /v2/generations/{generation_id} or supply a webhook_url.
Authentication
API key for access control. Use in the header with the name "Api-Key"
Query parameters
When true, the request is validated and priced but not run: nothing is
generated, stored, or billed, and no safety review is performed. The
response is a PriceQuote object instead of the usual response for this
endpoint. Send exactly the request you would send to generate, so the
quote reflects the same options.
Request
A request to produce a video from reference media with MiniMax H3. Use multipart/form-data to upload reference media.
A natural-language prompt describing the video to produce. Reference media is addressed by position, as in "Image 1 walks toward the camera with the motion of Video 1".
Images to use as references (max size 50MB each), as raw bytes, in prompt order; only common image formats such as JPEG, PNG, and WEBP are supported. Uploaded images are used for this request only and are not stored.
MP3 or WAV audio references, in prompt order as Audio 1, Audio 2, and Audio 3. Multipart uploads only; up to 15 MB per file and 2–15 seconds each. Audio and video references must total no more than 15 seconds. Requires a reference image or video. At most 12 references across images, videos, and audio. Used only for this request and not saved as assets.
The resolution tier of the generated video, spelled the way MiniMax
spells it. 480P and 768P are generated natively; 2K and 4K are
upscaled from a 768P result.
Higher tiers cost more.
How much the model may rewrite the prompt before generating. disabled
uses the prompt as written; the other modes trade latency for a richer
rewrite.
HTTPS URL that Ideogram delivers the generated result to. Ideogram sends a
JSON POST to this URL once all images for the request have finished
generating. The body mirrors the synchronous generate response:
request_id, created, and a data array
containing every generated image (url, prompt, resolution, seed,
is_image_safe). Each delivery is signed with Ed25519 and verifiable
against the public keys at https://api.ideogram.ai/v1/.well-known/jwks.json. Must be HTTPS;
private and loopback hosts and the cloud metadata service are rejected.
Response
An acknowledgement to poll with GET /v2/generations/{generation_id}.
URL-safe base64 ID of the accepted generation. Accepted by the
GET /v2/generations/{generation_id} polling endpoint.