MiniMax H3 API contract

Endpoint and authentication

POST https://aivideomaker.ai/api/v1/generate/minimax

Send JSON with Content-Type: application/json and the API key in the key request header. Quote the same payload first with POST /api/v1/quote/minimax. For creation, send a stable Idempotency-Key and the caller-approved X-Max-Credits limit.

Request fields

| Field | Type | Required | Accepted values and defaults | | -------------------- | -------------- | -------- | ------------------------------------------------------------------- | | content | string | Yes | Prompt or scene direction | | duration | integer | No | 5–20 seconds; default 5 | | resolution | string | No | 720p or 1080p; default 720p | | tier | string | No | turbo or base; default turbo | | aspectRatio | string | No | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; default 16:9 | | imageUrl | string or null | No | Public HTTP(S) image URL or image data URI | | lastFrameUrl | string or null | No | Public HTTP(S) image URL or image data URI | | referenceImageUrls | string[] | No | Up to 4 public image URLs or image data URIs | | referenceVideoUrl | string or null | No | One public HTTP(S) video URL | | referenceAudioUrls | string[] | No | Up to 2 public HTTP(S) audio URLs |

Frame inputs (imageUrl, lastFrameUrl) and reference assets are mutually exclusive. Image data URIs must use data:image/...;base64,.... Video and audio data URIs are not accepted.

API credit rates

Effective September 5, 2026:

| Configuration | API credits per generated second | USD example | | ------------- | -------------------------------: | ------------------: | | 720p Turbo | 3 | $0.03/second | | 720p Base | 4 | $0.04/second | | 1080p Turbo | 4 | $0.04/second | | 1080p Base | 5 | $0.05/second |

One API credit is USD $0.01. The quote endpoint is authoritative for a specific payload.

Input-mode examples

Text to video uses content without media fields. Frame to video may use imageUrl and lastFrameUrl. Reference to video may use reference images, one reference video, and/or reference audio, subject to the limits above.

Invalid fields, incompatible modes, insufficient credits, or rejected media return an error response and do not produce a successful generation result.