Skip to content

MiniMax H3 Reference to Video LoRA Trainer

Integrate

Model id minimax/h3/ref2va/trainer
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/h3/ref2va/trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip"
  }'

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

This request: $30.00 30,000 API credits Run it on this page

Get API key
MiniMax Training Reference inputs1–60 s

LoRA trainer for reference-conditioned video, with warm start from an earlier LoRA

Made on Doitong

Public works made with MiniMax H3 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

Мрачная комната для допросов, тесная и давящая. Одна резкая лампа под потолком бросает конус холодного света на металлический стол, вокруг густые тени. Виновный подозреваемый сидит в наручниках по одну сторону стола: потеет, нервно бегает глазами, тяжело дышит, избегает взгляда. Напротив —...

Build a request

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

resolution default medium

Training resolution. Increasing the resolution raises memory requirements.

aspect_ratio default 16:9

Choose the training aspect ratio from the same set available through the MiniMax H3 API.

•required

URL for a ZIP of subject training videos; image-only datasets and mixed image/video training archives are rejected, so images must instead be reference sidecars. Optional extras share each clip's base name: a caption such as `clip01.txt` and ordered references from `ref_1` through `ref_4`, named `clip01.ref_1.<ext>` through `clip01.ref_4.<ext>`; without reference sidecars, a frame from the clip supplies its own reference. The `<ext>` determines reference modality: images (.png/.jpg/.jpeg), audio (.wav/.mp3/.flac/.m4a/.ogg/.aac), or videos (.mp4/.mov/.avi/.mkv/.webm), whose soundtracks also become audio references. Training clips support .mp4, .mov, .avi, and .mkv; aim for at least 10 clips, with more preferred.

default 2000

Total count of training steps.

Advanced rank · trigger_phrase · resume_from_lora_url · learning_rate · number_of_frames · frame_rate · reference_conditioning_p · split_input_duration_threshold · auto_scale_input · split_input_into_scenes · debug_dataset · strict_dataset
rank default 32

LoRA adaptation rank, trading increased memory consumption for greater capacity as the setting rises.

default

LoRA style activation phrase, inserted at the start of captions during training.

URL for warm-start training with a .safetensors LoRA previously created by this trainer, followed by number_of_steps additional training steps. Nothing except the adapter weights is restored: both optimization and learning-rate scheduling begin anew.

default 0.0002

Optimization learning rate, balancing a possible speedup in training against the risk of overfitting when increased.

default 73

Frame count for each training sample; dividing it by 17 must leave a remainder of 5. Examples include 22, 39, 56, 73, 90, 107, and 124.

default 24

Target video frame rate, measured in frames per second.

default 0.9

Set how often training uses reference-image conditioning versus unconditioned text-to-video-audio training. Whatever probability remains goes to the unconditioned objective to maintain stable prompt-only generation.

default 30

Scene-splitting trigger expressed as a duration in seconds: only videos longer than the threshold are split.

POST /run/minimax/h3/ref2va/trainer?wait=20 quote → $30.00
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/h3/ref2va/trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 MiniMax H3 Reference to Video LoRA Trainer

Trains a LoRA on a zip of subject video clips so reference inputs can steer video generation. `reference_conditioning_p` sets how often references are used during training, and `resume_from_lora_url` continues from a previously trained LoRA. Also configurable: `rank`, `number_of_steps`, `number_of_frames`, `frame_rate` and `aspect_ratio`. Returns weights and a config file.

Parameters

NameType DefaultAllowed Description
training_data_urlrequired
Typestring
URL for a ZIP of subject training videos; image-only datasets and mixed image/video training archives are rejected, so images must instead be reference sidecars. Optional extras share each clip's base name: a caption such as `clip01.txt` and ordered references from `ref_1` through `ref_4`, named `clip01.ref_1.<ext>` through `clip01.ref_4.<ext>`; without reference sidecars, a frame from the clip supplies its own reference. The `<ext>` determines reference modality: images (.png/.jpg/.jpeg), audio (.wav/.mp3/.flac/.m4a/.ogg/.aac), or videos (.mp4/.mov/.avi/.mkv/.webm), whose soundtracks also become audio references. Training clips support .mp4, .mov, .avi, and .mkv; aim for at least 10 clips, with more preferred.
rankoptional
Typeenum
Default32
8163264128
LoRA adaptation rank, trading increased memory consumption for greater capacity as the setting rises.
number_of_stepsoptional
Typeinteger
Default2000
1 – 15,000
Total count of training steps.
learning_rateoptional
Typenumber
Default0.0002
0.000001 – 1
Optimization learning rate, balancing a possible speedup in training against the risk of overfitting when increased.
number_of_framesoptional
Typeinteger
Default73
22 – 124
Frame count for each training sample; dividing it by 17 must leave a remainder of 5. Examples include 22, 39, 56, 73, 90, 107, and 124.
frame_rateoptional
Typeinteger
Default24
8 – 60
Target video frame rate, measured in frames per second.
resolutionoptional
Typeenum
Defaultmedium
lowmediumhigh
Training resolution. Increasing the resolution raises memory requirements.
aspect_ratiooptional
Typeenum
Default16:9
21:916:94:31:13:49:16
Choose the training aspect ratio from the same set available through the MiniMax H3 API.
trigger_phraseoptional
Typestring
Default
LoRA style activation phrase, inserted at the start of captions during training.
reference_conditioning_poptional
Typenumber
Default0.9
0 – 1
Set how often training uses reference-image conditioning versus unconditioned text-to-video-audio training. Whatever probability remains goes to the unconditioned objective to maintain stable prompt-only generation.
resume_from_lora_urloptional
Typestring | null
URL for warm-start training with a .safetensors LoRA previously created by this trainer, followed by number_of_steps additional training steps. Nothing except the adapter weights is restored: both optimization and learning-rate scheduling begin anew.
auto_scale_inputoptional
Typeboolean
Defaultfalse
Whether the target fps and frame count are matched through automatic video scaling; true enables this adjustment.
split_input_into_scenesoptional
Typeboolean
Defaulttrue
Enable scene splitting for videos longer than a duration threshold, discarding reference sidecars from any clips that are split.
split_input_duration_thresholdoptional
Typenumber
Default30
1 – 60
Scene-splitting trigger expressed as a duration in seconds: only videos longer than the threshold are split.
debug_datasetoptional
Typeboolean
Defaultfalse
Option to download an archive for checking preprocessing before committing to full training. With this enabled, the trainer packages the processed dataset so you can manually inspect captions, reference images, videos, and images for correctness.
strict_datasetoptional
Typeboolean
Defaultfalse
Strict handling of preprocessing problems that would otherwise be logged and resolved using the documented fallback. Enabling it rejects captions needing blank prompts, missing reference sidecars, and videos with unreadable audio rather than allowing those fallbacks.
required

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3/ref2va/trainer",
  "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": 30000,
    "usd": "30.00",
    "charged": 30000,
    "refunded": 0
  },
  "input": {
    "training_data_url": "https://example.com/your-file.zip"
  },
  "output": {
    "lora_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "config_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "debug_dataset": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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
lora_file
object {url, content_type, file_name, file_size}URL for trained LoRA weights in .safetensors format.
config_file
object {url, content_type, file_name, file_size}Configuration for inference endpoint setup.
debug_dataset
object {url, content_type, file_name, file_size} | nullAvailable only for requests with `debug_dataset` enabled, this downloadable archive holds the training data after preprocessing.

More models: Training

For AI agents: this page as Markdown is at https://doitong.com/developers/models/minimax/h3/ref2va/trainer.md. All models and guides: https://doitong.com/developers/llms.txt