Create Video

Guides: Async jobs, Webhooks, Render a video with webhooks, Write prompts for MiniMax-H3

• model string required
• prompt string required

  Must be a string (a list or number is a 400).

  at most 8000 characters
• duration integer

  Seconds of video. minimax-h3 takes 4-15; default 6. A whole number sent as text ("8") is accepted.

• seconds integer

  OpenAI/Sora's name for duration; duration wins when both are sent.

• resolution string

  minimax-h3: 2K renders the 768p preset and enlarges it 2x (16:9 is 2688x1536). It bills 3 times the seconds times the quality tier, takes about 3 times as long, and runs at every tier: quality standard, max or ultra, or base num_inference_steps, renders the 768p preset on the base weights before the same upscale. 4K is the 2K render enlarged 1.5x by SeedVR2 after the engine (16:9 is 4032x2304, the soundtrack kept): it bills as 2K (the upscale is free), runs at Turbo only (any other tier at 4K is a 400), and takes about 18 s more per second of video, plus any wait for the upscaler; the job's output.upscale says it was applied.

  default 768p768p2K4K
• aspect_ratio string
  default 16:916:99:164:33:41:121:9
• size string

  Width x height; an alternative to aspect_ratio, and must agree with it when both are sent. The second six are 2K and the last six 4K (see resolution).

  1344x768768x13441024x768768x1024768x7681536x6722688x15361536x26882048x15361536x20481536x15363072x13444032x23042304x40323072x23042304x30722304x23044608x2016
• frame_images array of objects
  at most 2 items
  3 fields

  • type string required
    image_url
  • image_url object required
    1 field

    • url string required

      An https URL or a base64 data URI.

  • frame_type string required
    first_framelast_frame
• input_references array of objects

  Reference media for the subject, style or sound. Ignored when frame_images is sent.

  5 fields

  • type string required
    image_urlvideo_urlaudio_url
  • image_url object
    1 field

    • url string required

      An https URL or a base64 data URI.

  • video_url object
    1 field

    • url string required

      An https URL or a base64 data URI.

  • audio_url object
    1 field

    • url string required

      An https URL or a base64 data URI.

  • role string

    driving and control are reserved for models that support them.

    default referencereference
• input_reference string or object

  OpenAI/Sora's first frame, as an https URL (or base64 data URI) string or as {image_url}. Ignored when frame_images is sent. Any other type is a 400.

  One of 2

  • string
  • object
    • image_url string
• generate_audio boolean

  Strictly true or false (in multipart/form-data the text true or false); anything else is a 400.

  default true
• seed integer
• num_inference_steps integer

  minimax-h3: the number of denoising steps. Omit it for the Turbo LoRA (4 steps, or 8 with input_references); 10 to 50 runs the full base model, which takes longer and bills the quality tier whose step range holds the count: 10 to 20 as standard (1.5x), 21 to 40 as max (3x), 41 to 50 as ultra (5x; see Billing). Sending the Turbo count itself changes nothing. Prefer quality. Also accepted under provider.options (see provider).

  range 4–50
• quality string

  minimax-h3: the quality tier, the same in every mode. turbo (auto, low; the default) is the Turbo LoRA at 1x the price; standard (medium) is 20 base steps at 1.5x; max (high) is 40 base steps at 3x; ultra is 50 base steps at 5x. The job stores the tier's own name. Sending num_inference_steps too is a 400 unless it is the tier's count. Also accepted under provider.options (see provider).

  turbostandardmaxultraautolowmediumhigh
• start_time_seconds number

  minimax-h3: where to start reading each reference video in input_references, in seconds. Also accepted under provider.options (see provider).

  at least 0
• callback_url string

  An https URL notified on completion, failure, cancellation and expiry. See GET /v1/webhooks/secret.

• provider object

  OpenRouter's provider preferences. The routing fields (order, only, ignore, sort, allow_fallbacks, ...) are accepted and ignored. options carries the model's own settings (quality, num_inference_steps, start_time_seconds for minimax-h3; GET /v1/videos/models lists each model's allowed_passthrough_parameters) for clients that cannot add top-level fields. From OpenRouter's SDKs use options.stealth: they keep only the slugs on their closed list and drop any other, vultr included, without an error. The first form present wins, the top level before any option; a key the model does not declare is a 400 naming its path.

Fields as multipart/form-data

• model string required
• prompt string required
• seconds string
• size string
• input_reference string (binary)

  The first frame.

• generate_audio string
  truefalse
• callback_url string

curl https://api.vultrinference.com/v1/videos \
  -H "Authorization: Bearer $VULTR_INFERENCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "A red fox trots through fresh snow at dawn, breath steaming.",
    "duration": 6,
    "aspect_ratio": "16:9",
    "callback_url": "https://example.com/hooks/video"
  }'

import os
import requests

response = requests.post(
    "https://api.vultrinference.com/v1/videos",
    headers={"Authorization": f"Bearer {os.environ['VULTR_INFERENCE_API_KEY']}"},
    json={
        "model": "minimax-h3",
        "prompt": "A red fox trots through fresh snow at dawn, breath steaming.",
        "duration": 6,
        "aspect_ratio": "16:9",
        "callback_url": "https://example.com/hooks/video",
    },
)
print(response.json())

const response = await fetch("https://api.vultrinference.com/v1/videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VULTR_INFERENCE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "minimax-h3",
    "prompt": "A red fox trots through fresh snow at dawn, breath steaming.",
    "duration": 6,
    "aspect_ratio": "16:9",
    "callback_url": "https://example.com/hooks/video"
  }),
});
console.log(await response.json());

{
    "id": "video_3f2a9c1e7b4d5a6c8e0f1a2b",
    "object": "video",
    "model": "string",
    "status": "pending",
    "progress": 0,
    "created_at": 1790000000,
    "polling_url": "string"
}