MiniMax H3 Max Turbo · Image to Video

Animate a first-frame image with MiniMax H3 Max Turbo. Add an optional last frame to guide the ending, choose the duration and native resolution, and retrieve the video after the asynchronous task completes.

Developer API pricing

Provider: fal

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

480P: 12 credits/sec (≈ $0.045/sec)

768P: 18 credits/sec (≈ $0.067/sec)

1080P: 32 credits/sec (≈ $0.12/sec)

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A new, stable key for each generation request. Reuse it only when retrying the same request body.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The model ID shown in the selected model's API documentation.

Allowed:minimax-h3-max-turbo

Default:: minimax-h3-max-turbo
Example:: minimax-h3-max-turbo

stringrequired

Image to Video. Use the Endpoint ID shown in this model's API documentation.

Allowed:image-to-video

Default:: image-to-video
Example:: image-to-video

stringoptional

Optional public Provider ID. Omit it to use the Endpoint default Provider (fal).

Allowed:fal

Default:: fal
Example:: fal

objectrequired

Generation settings for the selected Provider. Supply the fields in this group inside input.

Provider parameters

falfalDefault Provider

string <uri>required

URL of the image used as the opening frame. The generated video follows the aspect ratio of this image.

A first-frame image is required for this Image to Video endpoint.
Use a publicly accessible image URL.

Example:: https://client.example.com/input.png

string <uri>optional

Optional URL of the final frame. Supply it together with first_frame_image to guide a transition from the starting image to the ending image.

stringrequired

Describe the motion, subject actions, scene changes, and camera movement to generate from the starting image.

min length: 1max length: 50000

Example:: A cinematic city at night

numberoptional

Length of the generated video, in seconds. Provide a whole number.

min: 5max: 15

Default:: 5

stringoptional

Native generation resolution of the video. Choose 480P or 768P;

Allowed:480P768P1080P

Default:: 768P

stringoptional

Controls how much effort is spent expanding your prompt before video generation. balanced favors a short rewrite; quality produces a more detailed rewrite.

balanced prompt expansion takes about one second; quality can take up to approximately 30 seconds. This is prompt rewriting time, not total video generation time.

Allowed:balancedquality

Default:: balanced

numberoptional

Integer seed used to initialize generation randomness. If omitted, a random seed is selected.

string <uri>optional

An absolute HTTPS URL that receives the terminal generation Webhook.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: minimax-h3-max-turbo

stringrequired

Example:: image-to-video

stringrequired

Allowed:fal

fal: fal

Example:: fal

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 90

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: minimax-h3-max-turbo

stringrequired

Example:: image-to-video

stringrequired

Allowed:fal

fal: fal

Example:: fal

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 90

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "minimax-h3-max-turbo",
  "endpoint": "image-to-video",
  "provider": "fal",
  "input": {
    "first_frame_image": "https://client.example.com/input.png",
    "prompt": "A cinematic city at night",
    "duration_seconds": 5,
    "resolution": "768P",
    "prompt_expansion_mode": "balanced"
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "minimax-h3-max-turbo",
    "endpoint": "image-to-video",
    "provider": "fal",
    "status": "processing",
    "estimated_credits": 90,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "minimax-h3-max-turbo", "endpoint": "image-to-video", "provider": "fal", "input": { "first_frame_image": "https://client.example.com/input.png", "prompt": "A cinematic city at night", "duration_seconds": 5, "resolution": "768P", "prompt_expansion_mode": "balanced" }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "minimax-h3-max-turbo", "endpoint": "image-to-video", "provider": "fal", "status": "processing", "estimated_credits": 90, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: minimax-h3-max-turbo

stringrequired

Example:: image-to-video

stringrequired

Allowed:fal

fal: fal

Example:: fal

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 90

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: minimax-h3-max-turbo

stringrequired

Example:: image-to-video

stringrequired

Allowed:fal

fal: fal

Example:: fal

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 90

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable