MiniMax H3 API

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "A paper boat drifts across a still pond at dawn, mist on the water, slow push-in, soft natural light" }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9"
  }
}

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "The hominids step back as the sun rises behind the monolith, slow push-in" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg" } }
    ],
    "resolution": "768P",
    "duration": 6
  }
}

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "The ring-shaped station slowly turns to face the camera as an amber planet rises behind it" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } },
      { "type": "image_url", "role": "last_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/ending.jpg" } }
    ],
    "resolution": "768P",
    "duration": 6
  }
}

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "Shot 1: the black monolith from image 1 stands on a savanna at dawn. Shot 2: match cut to the ring-shaped space station from image 2, tumbling slowly in black space." },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } }
    ],
    "resolution": "768P",
    "duration": 8,
    "ratio": "16:9"
  }
}

Reference video

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "Follow the camera movement and pacing of video 1, set on the space station from image 1" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } },
      { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/1.mp4" } }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }
}

Reference audio

{
  "model": "minimax-h3",
  "input": {
    "content": [
      { "type": "text", "text": "The astronaut from image 1 speaks to the camera inside the station, in the voice of audio 1" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/astronaut.png" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/voice.mp3" } }
    ],
    "resolution": "768P",
    "duration": 8,
    "ratio": "16:9"
  }
}

cURL

curl https://api.vizoapi.com/v1/generations \
  -H "Authorization: Bearer $VIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A paper boat drifting on a pond at dawn, slow dolly in"
      }
    ],
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 6
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}'

Python

import os, requests

# Send once: do not retry this request automatically.
task = requests.post(
    "https://api.vizoapi.com/v1/generations",
    headers={"Authorization": f"Bearer {os.environ['VIZO_API_KEY']}"},
    json={
      "model": "minimax-h3",
      "input": {
        "content": [
          {
            "type": "text",
            "text": "A paper boat drifting on a pond at dawn, slow dolly in"
          }
        ],
        "resolution": "768P",
        "ratio": "16:9",
        "duration": 6
      },
      "metadata": {
        "client_reference": "my-unique-reference-1"
      }
    },
    timeout=60,
).json()
print(task["id"], task["status"])

Node.js

// Send once: do not retry this request automatically.
const res = await fetch("https://api.vizoapi.com/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIZO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "minimax-h3",
    "input": {
      "content": [
        {
          "type": "text",
          "text": "A paper boat drifting on a pond at dawn, slow dolly in"
        }
      ],
      "resolution": "768P",
      "ratio": "16:9",
      "duration": 6
    },
    "metadata": {
      "client_reference": "my-unique-reference-1"
    }
  }),
});
const task = await res.json();
console.log(task.id, task.status);

202 Accepted

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "minimax-h3",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "108.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 Succeeded

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "minimax-h3",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "108.000",
    "reserved": "0.000",
    "charged": "108.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "video/mp4"
      }
    ]
  }
}