Developer tutorial

How to Use MiniMax H3 Max API

This is a safe starting structure, not an assertion that an endpoint or field is currently available. Verify every provider-specific detail before running code.

This is an independent review, not affiliated with MiniMax or fal.ai.

Before you start

• An account with your chosen API platform.
• An API key stored in an environment variable, never committed to source control.
• Access to the current model and endpoint documentation.
• A small, bounded test budget and a saved test prompt.

Method A: fal.ai

Step 1: confirm the endpoint and schema

The URL below is the requested draft endpoint. Confirm the endpoint, accepted fields, output field, authentication policy, and model availability in fal documentation before use.

Step 2: send a test request

import os
import requests

url = "https://fal.run/minimax/h3-max/text-to-video"
headers = {
    "Authorization": f"Key {os.environ['FAL_KEY']}",
    "Content-Type": "application/json",
}
payload = {
    "prompt": "A quiet editorial test scene, clearly lit and reproducible.",
    "resolution": "480p",  # Confirm the exact fal field/value in official docs.
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
video_url = data["REPLACE_WITH_VERIFIED_VIDEO_URL_FIELD"]  # 【FILL: actual video URL field from API response】
print(video_url)

Step 3: inspect the result

Save the request payload, complete response shape, generated asset, elapsed time, and billing record together. 【FILL: replace with the actual returned video URL field after verification】.

Method B: OpenRouter

Use the current OpenRouter documentation to confirm whether and how this model is exposed. The template deliberately does not guess an endpoint or model identifier.

import os
import requests

url = "REPLACE_WITH_VERIFIED_OPENROUTER_ENDPOINT"  # 【FILL: OpenRouter endpoint; see README or official docs to confirm】
payload = {
    "model": "REPLACE_WITH_VERIFIED_OPENROUTER_MODEL_ID",  # 【FILL: OpenRouter model id; see README or official docs to confirm】
    "prompt": "A quiet editorial test scene, clearly lit and reproducible.",
    "resolution": "480p",  # Confirm field names and supported values.
}
headers = {"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}"}
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

Parameters to verify

Real example record

Prompt: 【FILL: exact production test prompt】
Generation time: 【FILL: measured end-to-end generation time】

Troubleshooting

【FILL: add only real, reproducible errors and tested resolutions; do not invent error codes】.

FAQ

Last updated: September 3, 2026