Skip to content

H3 Max Reference to Video

Integrate

Model id minimax/h3-max/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/minimax/h3-max/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "prompt_expansion_mode": "balanced"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.40 400 API credits · ≈ ₽42.63 your files are measured before the run Run it on this page

Get API key
MiniMax Reference to Video Reference inputs0.92–15 sup to 1080P #stylized#transform#typography

H3 Max video generation that keeps subjects consistent using reference images, videos and audio clips

Made on Doitong

Public works made with Hailuo 03 New Turbo by the Doitong community. Reuse a prompt in one click.

Public works shown: 16
Close-up shot of a striking model with piercing eyes and flawless skin, a white snake elegantly c... Video

Close-up shot of a striking model with piercing eyes and flawless skin, a white snake elegantly coiled around her head and neck, its scales glistening in soft, diffused light. The camera gently zooms in, emphasizing the intricate texture of the snake’s scales and the model’s striking facial...

Animate the stickman drawings into a smooth dance animation. The simple black stick figure perfor... Video

Animate the stickman drawings into a smooth dance animation. The simple black stick figure performs fun rhythmic dance moves — waving its arms, bending knees, jumping lightly, spinning, and swaying side to side in time with upbeat music. Keep the white background clean and minimal. The motion...

A hyper-realistic, cinematic transformation sequence of the man in the uploaded image, sitting in... Video

A hyper-realistic, cinematic transformation sequence of the man in the uploaded image, sitting in meditation inside a traditional Japanese room. The atmosphere begins to tremble slightly as soft blue light flows around him. From the ground, thousands of magnetic nano-particles rise, shimmering...

A cinematic transformation video of the man. The scene begins with him standing naturally, then l... Video

A cinematic transformation video of the man. The scene begins with him standing naturally, then looking down at his hands as glowing holographic projections appear around his body. Mechanical parts of the Iron Man armor start assembling piece by piece with smooth animation: chest plate forming,...

An ultra-epic anime cinematic of Luffy’s greatest enemy unleashing a terrifying blind rage, rampa... Video

An ultra-epic anime cinematic of Luffy’s greatest enemy unleashing a terrifying blind rage, rampaging uncontrollably against nature itself. His gigantic body is surrounded by a storm of black and crimson energy, crackling with lightning that scorches the ground. His roar shakes the heavens,...

A fair-skinned red-haired woman with freckles tightly embraces a majestic white tiger with faint ... Video

A fair-skinned red-haired woman with freckles tightly embraces a majestic white tiger with faint reddish stripes. They remain close, perfectly synchronized in stillness. The woman blinks slowly, slightly tilting her head with a serious and intense expression. The tiger breathes gently — its...

The snowboarder is riding across massive, fluffy white clouds as if they were snow-covered mounta... Video

The snowboarder is riding across massive, fluffy white clouds as if they were snow-covered mountains, with dramatic lighting and deep shadows adding volume and realism. The background shows a stunning blue sky with scattered soft clouds and subtle light rays. crisp cinematic quality, vivid...

Video

Используй это изображение как точный референс. Вертикальное реалистичное видео 9:16, тёплая кинематографичная ночная сцена в спальне. Полностью сохранить лица Ани и Павла, их внешность, причёски, одежду, освещение, кровать, панорамные окна и ночной город. Камера статичная, средний крупный план....

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 88 / 50000

Video-generation instructions with references identified by asset type and position within each reference list, using labels such as Audio 1, Video 1, Image 1, Image 2, and so on.

•required

Pre-generation prompt rewriting effort: 'quality' develops a richer prompt over as much as approximately 30s, while 'balanced' returns in roughly a second. Choose 'disabled' to omit prompt expansion.

resolution default 768P

Generation resolution selection: 1080P requires latent refinement of material generated natively at 768P, rather than native generation at the selected resolution.

aspect_ratio default adaptive

Aspect ratio for the output video.

default 5

Requested duration in seconds, allowing an actual video length up to approximately 0.7 s beyond that request.

Advanced images · reference_video_urls · reference_audio_urls · image · middle_image_url · end_image · middle_frame_time · seed · enable_safety_checker · reference_conditions
reference_image_urls
Drop a file, or · up to 9

Subject or style reference image URLs, sharing a 12-file maximum with all video and audio references. Identify these images in the prompt by list position using Image 1, Image 2, and subsequent labels.

Drop a file, or · up to 3

Motion or other reference video URLs, identified by list position in the prompt using Video 1, Video 2, and subsequent labels. The shared allowance across image, video, and audio references is 12 files; video clips must each last 2–15 seconds and total no more than 15 seconds.

Drop a file, or · up to 3

Supply reference audio as URLs and identify the clips in the prompt using Audio 1, Audio 2, and subsequent labels. Each clip must be 2–15 seconds long, with no more than 15 seconds of audio in total. Any of the image, video, and audio reference types can be supplied alone or combined, subject to a shared maximum of 12 files.

image_url
Drop a file, or

Optional image URL defining the exact opening frame and determining the output canvas. Reference assets maintain subject consistency.

Drop a file, or

Optional guiding image for middle_frame_time, available only with native 480P or 768P generation and with both a starting image and an ending image supplied.

end_image_url
Drop a file, or

Optional final-image URL that fixes the video's exact ending frame to the supplied image.

Middle-image placement time, usable only with middle_image_url and restricted to positions strictly inside the requested video's first and last frames. Supply seconds elapsed since the start; the value is rounded to the nearest 24 fps frame.

Seed for random generation; if omitted, one is chosen randomly.

Reference list supplied as an alternative to reference_*_urls, never alongside them. Ordering across modalities carries meaning, so the sequence is maintained throughout processing.

POST /run/minimax/h3-max/reference-to-video?wait=20 quote → $0.40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/minimax/h3-max/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "prompt_expansion_mode": "balanced"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About H3 Max Reference to Video

Generates video guided by reference assets: up to 9 images, 3 videos and 3 audio clips, with at most 12 files in total. The prompt refers to them as Image 1, Video 1, Audio 1 and so on. Optional first, middle (`middle_image_url` at `middle_frame_time`) and last frames pin the start, middle and end. `duration` is 0.92 to 15 seconds, and `aspect_ratio` can be adaptive.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 50,000 characters
Video-generation instructions with references identified by asset type and position within each reference list, using labels such as Audio 1, Video 1, Image 1, Image 2, and so on.
reference_image_urlsoptional images
Typeurl[] · image
≤ 9 items
Subject or style reference image URLs, sharing a 12-file maximum with all video and audio references. Identify these images in the prompt by list position using Image 1, Image 2, and subsequent labels.
reference_video_urlsoptional
Typeurl[] · video
≤ 3 items
Motion or other reference video URLs, identified by list position in the prompt using Video 1, Video 2, and subsequent labels. The shared allowance across image, video, and audio references is 12 files; video clips must each last 2–15 seconds and total no more than 15 seconds.
reference_audio_urlsoptional
Typeurl[] · audio
≤ 3 items
Supply reference audio as URLs and identify the clips in the prompt using Audio 1, Audio 2, and subsequent labels. Each clip must be 2–15 seconds long, with no more than 15 seconds of audio in total. Any of the image, video, and audio reference types can be supplied alone or combined, subject to a shared maximum of 12 files.
image_urloptional image
Typeurl · image
Optional image URL defining the exact opening frame and determining the output canvas. Reference assets maintain subject consistency.
middle_image_urloptional
Typeurl · image
Optional guiding image for middle_frame_time, available only with native 480P or 768P generation and with both a starting image and an ending image supplied.
middle_frame_timeoptional
Typenumber | null
> 0< 15
Middle-image placement time, usable only with middle_image_url and restricted to positions strictly inside the requested video's first and last frames. Supply seconds elapsed since the start; the value is rounded to the nearest 24 fps frame.
end_image_urloptional end_image
Typeurl · image
Optional final-image URL that fixes the video's exact ending frame to the supplied image.
durationoptional
Typenumber
Default5
0.92 – 15
Requested duration in seconds, allowing an actual video length up to approximately 0.7 s beyond that request.
resolutionoptional
Typeenum
Default768P
480P768P1080P
Generation resolution selection: 1080P requires latent refinement of material generated natively at 768P, rather than native generation at the selected resolution.
seedoptional
Typeinteger | null
Seed for random generation; if omitted, one is chosen randomly.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety checker activation; true enables checking.
prompt_expansion_moderequired
Typestring
Defaultbalanced
Pre-generation prompt rewriting effort: 'quality' develops a richer prompt over as much as approximately 30s, while 'balanced' returns in roughly a second. Choose 'disabled' to omit prompt expansion.
aspect_ratiooptional
Typeenum
Defaultadaptive
adaptive21:916:94:31:13:49:16
Aspect ratio for the output video.
reference_conditionsoptional
Typeobject[]
≤ 12 items
Reference list supplied as an alternative to reference_*_urls, never alongside them. Ordering across modalities carries meaning, so the sequence is maintained throughout processing.
reference_conditions[].typerequired
Typeenum
imagevideoaudio
Modality of the reference; ordering across modalities in the list carries meaning.
reference_conditions[].urlrequired
Typestring
≥ 1 characters
Reference media's URL.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3-max/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "prompt_expansion_mode": "balanced"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "expanded_prompt": "string",
    "seed": 42,
    "timings": {}
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size}Video produced by the model.
expanded_prompt
string | nullModel-ready expanded prompt, or null if no expanded text is available. The null cases are disabled expansion, expansion that made no change, and expansion handled internally by the model's hosted API.
seed
integerBase seed used to reproduce the generated result.
timings
object | nullTiming measurements expressed in seconds, available only on routes reporting backend timings; otherwise null. The 'inference' entry measures how long DiT denoising took on the GPU backend.

More models: Reference to Video

For AI agents: this page as Markdown is at https://doitong.com/en-GB/developers/models/minimax/h3-max/reference-to-video.md. All models and guides: https://doitong.com/developers/llms.txt