For the complete documentation index, see llms.txt. This page is also available as Markdown.

Minimax H3 Lite

This documentation is valid for the following list of our models:

  • minimax/h3-lite

Model Overview

MiniMax H3 Lite generates lower-cost 4-15 second videos at 480p or 768p with synchronized audio, from text, first/last frames, or image, video and audio references. Reference generation requires a concrete aspect ratio.

Setup your API Key

If you don't have an API key yet, use our Quickstart guide.

How to Make a Call

Step-by-Step Instructions

Generating a video involves sequentially calling two endpoints:

  • Create and submit a video generation task. The response contains a generation ID.

  • Poll the retrieval endpoint with that generation ID until the status is completed.

API Schemas

Create a video generation task and send it to the server

post
Body
modelstring · enumRequiredPossible values:
promptstring · max: 7000Required

The text description of the scene, subject, or action to generate in the video.

image_urlstring · uriOptional

A direct link to an online image or a Base64-encoded local image that will serve as the first frame for the video. Image specifications:

  • format must be JPG, JPEG, or PNG;
  • aspect ratio should be greater than 2:5 and less than 5:2;
  • the shorter side must exceed 300 pixels;
  • file size must not exceed 20MB.
last_image_urlstring · uriOptional

A direct link to an online image or a Base64-encoded local image to be used as the last frame of the video.

reference_image_urlsstring · uri[] · max: 9Optional

Passing an image reference allows the model to emulate the style or content of the reference in the output.

video_urlsstring · uri[] · max: 3Optional

Passing a video reference allows the model to emulate the style or content of the reference in the output.

audio_urlsstring · uri[] · max: 3Optional

Reference audio clips whose voice timbre the generated speech follows. Cannot be the only reference — pass at least one reference image or video alongside.

durationinteger · min: 4 · max: 15Optional

The length of the output video in seconds.

Default: 6
resolutionstring · enumOptional

The resolution of the output video, where the number refers to the short side in pixels.

Default: 768PPossible values:
ratiostring · enumOptional

Reference generation defaults to 16:9 and requires a concrete ratio. Image-to-video follows the frame aspect ratio.

Default: 16:9Possible values:
Responses
200

Successful response.

application/json
idstringRequired

The ID of the generated video.

Example: 60ac7c34-3224-4b14-8e7d-0aa0db708325
statusstring · enumRequired

The current status of the generation task.

Example: completedPossible values:
videoany ofOptional
or
or
any · nullableOptional
post/v2/video/generations
curl --request POST \
  --url 'https://api.aimlapi.com/v2/video/generations' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"model": "minimax/h3-lite", "prompt": "Describe what you want the model to generate.", "image_url": "https://example.com/input.jpg", "duration": 6}'
200

Successful response.

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
  },
  "error": {
    "name": "text",
    "message": "text"
  },
  "meta": {
    "usage": {
      "credits_used": 120000,
      "usd_spent": 0.06
    }
  }
}

Retrieve the generated video from the server

Poll this endpoint with the generation_id returned by the submit request. When the status is completed, the response includes the generated video URL.

get
Authorizations
AuthorizationstringRequired

Bearer key

Query parameters
generation_idstringRequiredExample: <REPLACE_WITH_YOUR_GENERATION_ID>
Responses
200Success
application/json
idstringRequired

The ID of the generated video.

Example: 60ac7c34-3224-4b14-8e7d-0aa0db708325
statusstring · enumRequired

The current status of the generation task.

Example: completedPossible values:
get/v2/video/generations
curl -L \
  --request GET \
  --url 'https://api.aimlapi.com/v2/video/generations?generation_id=<REPLACE_WITH_YOUR_GENERATION_ID>' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>'
200Success
{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
  },
  "error": {
    "name": "text",
    "message": "text"
  },
  "meta": {
    "usage": {
      "credits_used": 120000
    }
  }
}

Code Example

The examples submit a generation task and poll every 15 seconds until the final result is available.

Response

Last updated

Was this helpful?