MiniMax: H3 (Reference to Video) API Reference

About

MiniMax H3 is a frontier video model. This endpoint generates 2K video from multimodal references up to 9 images for subject and style

1. Calling the API

Setup your API Key

To begin using Infron, you first need to create an account and generate your API Key.

Once you have your API key, set it as an environment variable in your runtime environment. This allows your applications to securely access Infron’s API.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

For long-running requests, you can poll for results.

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/minimax-h3/reference-to-video",
  "prompt": "- Use Image 1 as the locked character reference. Preserve the half-up long black hair, openwork silver crown, indigo ribbon, layered pale hanfu, translucent blue outer robe, deep-blue sash, silver floral fastener, and long tassels. Use Image 1 for storyboard order and pacing. - Render in high-quality 4K, 16:9 Chinese-inspired 3D with cinematic xianxia production value: intense, solemn, and shaped by destiny. Follow the storyboard beat by beat, with natural camera movement and seamless transitions—never a slideshow. Show the face only in close-up or extreme close-up. In wide shots, use back view, rear three-quarter view, or empty environment shots; never show a distant frontal face.",
  "image_urls": ["https://storage.googleapis.com/infron_gcs/quick-upload/2026/08/31/20260831-112610-eea04d7d-fir_img.png"],
  "video_urls": [],
  "audio_urls": [],
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "watermark": false
}'

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260831032724322071467ZftatrR7",
    "object": "video",
    "model": "minimax/minimax-h3/reference-to-video",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/videos/tasks/20260831032724322071467ZftatrR7"
    },
    "created_at": "2026-08-31 03:27:24.36"
  }
}

Fetch request status

You can fetch the status of a request to check if it is completed or still in progress.

curl https://media.onerouter.pro/v1/videos/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

# For example
curl https://media.onerouter.pro/v1/videos/tasks/20260831032724322071467ZftatrR7 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260831032724322071467ZftatrR7",
    "object": "video",
    "model": "minimax/minimax-h3/reference-to-video",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1788146844,
    "start_time": 1788146844,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-08-31 03:27:24"
  }
}

Possible statuses:

• created
• in_progress
• processing
• completed
• failed

created -> in_progress → processing → completed | failed

Poll every 1-2 seconds until status is "completed" or "failed"

Get the result (when status is "completed")

Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260831032724322071467ZftatrR7",
    "object": "video",
    "model": "minimax/minimax-h3/reference-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1788146844,
    "start_time": 1788146844,
    "finish_time": 1788147114,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_ca38312f-1d5c-4305-a067-75f7a1932854.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 5,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "2K",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 0.69,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 0.69,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-08-31 03:27:24"
  }
}

2. Schema

Input

Example request

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/minimax-h3/reference-to-video",
  "prompt": "- Use Image 1 as the locked character reference. Preserve the half-up long black hair, openwork silver crown, indigo ribbon, layered pale hanfu, translucent blue outer robe, deep-blue sash, silver floral fastener, and long tassels. Use Image 1 for storyboard order and pacing. - Render in high-quality 4K, 16:9 Chinese-inspired 3D with cinematic xianxia production value: intense, solemn, and shaped by destiny. Follow the storyboard beat by beat, with natural camera movement and seamless transitions—never a slideshow. Show the face only in close-up or extreme close-up. In wide shots, use back view, rear three-quarter view, or empty environment shots; never show a distant frontal face.",
  "image_urls": ["https://storage.googleapis.com/infron_gcs/quick-upload/2026/08/31/20260831-112610-eea04d7d-fir_img.png"],
  "video_urls": [],
  "audio_urls": [],
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "watermark": false
}'

Output

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260831032724322071467ZftatrR7",
    "object": "video",
    "model": "minimax/minimax-h3/reference-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1788146844,
    "start_time": 1788146844,
    "finish_time": 1788147114,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_ca38312f-1d5c-4305-a067-75f7a1932854.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 5,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "2K",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 0.69,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 0.69,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-08-31 03:27:24"
  }
}

3. Detailed Pricing