> ## Documentation Index > Fetch the complete documentation index at: https://docs.linkmodel.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax-H3 > MiniMax's omni-modal audio-video generation system unifies text, image, video, and audio context to create videos up to 15 seconds at 2K with native stereo sound for advertising, e-commerce, and film production. ## OpenAPI ````yaml /openapi/video/minimax-h3.yaml post /videos/generations openapi: 3.0.3 info: title: MiniMax-H3 version: 1.0.0 description: >- MiniMax's omni-modal audio-video generation system unifies text, image, video, and audio context to create videos up to 15 seconds at 2K with native stereo sound for advertising, e-commerce, and film production. servers: - url: https://api.linkmodel.ai/v1 description: Production security: - bearerAuth: [] tags: - name: MiniMax - name: video paths: /videos/generations: post: tags: - MiniMax - video summary: MiniMax-H3 description: > MiniMax's omni-modal audio-video generation system unifies text, image, video, and audio context to create videos up to 15 seconds at 2K with native stereo sound for advertising, e-commerce, and film production. | | | | --- | --- | | **Provider** | MiniMax | | **Tasks** | text-to-video · image-to-video | | **Starting from** | 0.000000 USD / call · Pricing details | ## Task lifecycle This endpoint creates an asynchronous task. Poll `GET /videos/generations/{task_id}` with the returned `task_id` until the task reaches a terminal state. If the POST request times out or its result is uncertain, do not blindly retry it. The original request may already have created another task and billing order. Completed asset URLs are dynamically signed. Download or copy assets that must be retained instead of treating the URLs as permanent identifiers. operationId: minimax-h3 requestBody: required: true content: application/json: schema: type: object properties: prompt: type: string minLength: 1 description: Length must be at least 1. first_frame_image: type: string format: url description: Cannot be mixed with reference image, video or audio inputs. last_frame_image: type: string format: url description: >- Optional; cannot be mixed with reference image, video or audio inputs. images: type: array maxItems: 9 items: type: string format: url description: Up to 9 images; cannot be mixed with first/last frame mode. videos: type: array maxItems: 3 items: type: string format: url description: Up to 3 videos. audio_url: type: string format: url description: >- Reference audio requires at least one reference image or video. audios: type: array maxItems: 3 items: type: string format: url description: >- Up to 3 audio inputs in total; reference audio requires an image or video. duration: type: integer default: 5 minimum: 4 maximum: 15 description: 4 to 15 seconds. Defaults to `5`. Value is in s. resolution: type: string enum: - 2K - 768P default: 768P description: 'Must be one of: 2K, 768P. Defaults to `768P`.' size: type: string enum: - 16x9 - 1x1 - 21x9 - 3x4 - 4x3 - 9x16 - adaptive default: 16x9 description: >- Text-to-video requires a fixed ratio; adaptive is for requests with visual input. Defaults to `16x9`. model: type: string enum: - MiniMax-H3 required: - model - prompt responses: '200': description: >- Business response. `code=0` means the task was accepted; validation failures can return HTTP 200 with `code=400`. content: application/json: schema: oneOf: - type: object required: - code - data - msg properties: code: type: integer enum: - 0 example: 0 data: type: object required: - task_id properties: task_id: type: string description: Use this id to poll task status. example: aurora_abc123 order_id: type: string description: Billing order id. example: 019da9cf-d1db-78e1-ac23-526774d01193 status: type: string example: Processing price: type: number description: Charged amount in the model's pricing currency. example: 0.074 msg: type: string example: success request_id: type: string format: uuid example: 250b66dd-e1fb-4bb6-b5f6-c668efadc35d - type: object required: - code - msg properties: code: type: integer enum: - 400 example: 400 data: type: object example: {} msg: type: string example: model is required request_id: type: string format: uuid example: 96be7a7d-3e81-4916-a6b8-19b32773a693 '400': description: >- Malformed HTTP request rejected by the Gateway. Model and parameter validation may instead use HTTP 200 with business `code=400`. content: application/json: schema: type: object properties: code: type: integer example: 400 msg: type: string example: task_id is required request_id: type: string format: uuid example: 96be7a7d-3e81-4916-a6b8-19b32773a693 '401': description: Unauthorized — missing or invalid API key. content: application/json: schema: type: object properties: code: type: integer example: 401 data: type: object example: {} msg: type: string example: invalid api key request_id: type: string format: uuid example: bff4c295-c7da-4507-9708-4627cb6373ba '500': description: Internal error — task creation failed (e.g. insufficient balance). content: application/json: schema: type: object properties: code: type: integer example: 500 msg: type: string example: >- create task failed: billing: code=100601: insufficient balance request_id: type: string format: uuid example: 3409f6fb-fa9a-4534-b530-195b5f6f4e32 components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````