H3 Max Reference to Video
集成
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"
const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/minimax/h3-max/reference-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/minimax/h3-max/reference-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/zh-CN/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "minimax/h3-max/reference-to-video",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced"
}
}
通过 Doitong API 调用 H3 Max Reference to Video 模型(minimax/h3-max/reference-to-video)。智能体文档:https://doitong.com/zh-CN/developers/models/minimax/h3-max/reference-to-video.md
POST https://api.doitong.ru/v1/run/minimax/h3-max/reference-to-video?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced"
}
如果响应状态为 "queued" 或 "running",请轮询 GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20,直到状态变为 "succeeded";文件位于 outputs[].url。使用相同请求体 POST https://api.doitong.ru/v1/quote/minimax/h3-max/reference-to-video,可在运行前返回确切价格。
与示例类似的文件: $0.40 400 API 积分 · ≈ ₽42.63 运行前会测量你的文件 在此页面运行
你的新 API 密钥。 它只会在此时显示,并且已填入下方的代码和 API 密钥字段中。请妥善保管:切勿将其放入在浏览器中运行的代码里。
在 Doitong 上制作
Doitong 社区使用 Hailuo 03 New Turbo 制作的公开作品。一键复用提示词。
视频
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 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 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 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, 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 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 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...
Используй это изображение как точный референс. Вертикальное реалистичное видео 9:16, тёплая кинематографичная ночная сцена в спальне. Полностью сохранить лица Ани и Павла, их внешность, причёски, одежду, освещение, кровать, панорамные окна и ночной город. Камера статичная, средний крупный план....
视频
Героя Валеру не меняем . Валера в ужасе бежит вниз по лестнице в подъезде сильно хромает на правую ногу и держится за перила . Останавливается на лестничной площадки и потирает рукой правое колено на лице мучительная боль . Бежит дальше по лестнице открывает дверь подъездную , спотыкается и...
视频
Первый кадр - взгляд от первого лица , моргание глаз и видно сначала мутно потом ясно. На белом фоне стоит спиной к нам в белом медицинском халате и шапочке тело с ярко аппетитными формами женского тела , ноги ниже халата ноги скелета в ярких ярких красных туфлях , двигает комично попой влево и...
视频
На белом фоне . 9:16 Перед глазами Валеры закрывается шторка голубого цвета . Камера отдаляется и показывает Валеру без штанов и без тапок в операционной: на операционном столе Валера и половину тела разделяет медицинская шторка голубого цвета , а около ног стоит скелет в Маске и медицинском...
视频
В расслабленном состоянии и довольные собой :Скелет ,сустав и доктор Ларин ( Доктор Ларин непрерывно двигает губами, как будто говорит, выразительные движения губ, оживление речи.) сидят за столом в комнате для отдыха и пьют чай Камера направляется на скелета , который делает глоток чая и...
视频
Локацию не меняем , плакаты и расположение вещей не меняем .Меняем время зелёного цвета на часах на”03: 19” .Сверху на часах лежит медицинская шапочка скелета. Валере приснился страшный сон. он ворочается и в ужасе просыпается , сердце бьется сильно ,течет пот, он часто дышит , понимает ,что это...
Camera: dolly in. Медленная кинематографичная панорама Гели и её питомцев-хранителей на залитой солнцем деревянной террасе. Легкий ветерок шелестит листвой в саду, в воздухе парят золотистые пылинки. пусть она будет в шортиках и футболке в розовых сандалях. А Рокси голосом мужским приятным ....
Camera: static. Оживи это изображение строго в 2D-анимационном стиле. Сохрани формат 9:16. Не меняй стиль картинки, цветовую гамму и уровень детализации. В кадре уже есть Василиса. Её не генерировать заново. Остальные персонажи — за кадром. Их не показывать, не добавлять, не рисовать. Порядок...
Slapstick Tom & Jerry style silent comedy, Pixar-quality 3D animation, 16:9, Malar Sunai — a glowing mountain pond surrounded by blue and purple Neelakurinji flowers under a twilight sky, jackfruit tree nearby. Komban the young elephant with TWO tusks, KANNUKUTTI the bipedal yellow calf on two...
构建请求
控件根据模型架构生成。修改控件时,代码和价格会同步更新。
/run/minimax/h3-max/reference-to-video?wait=20
报价 → $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"
const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/minimax/h3-max/reference-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/minimax/h3-max/reference-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "minimax/h3-max/reference-to-video",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
"prompt_expansion_mode": "balanced"
},
"wait_seconds": 20
}
}
}
关于 H3 Max Reference to Video
根据参考素材生成视频:最多 9 张图像、3 个视频和 3 个音频片段,总文件数最多 12 个。提示词中将它们称为 Image 1、Video 1、Audio 1 等。可选的首帧、中间帧(`middle_image_url` 位于 `middle_frame_time`)和尾帧可固定开始、中间和结束画面。`duration` 为 0.92 到 15 秒,`aspect_ratio` 可设为 adaptive。
参数
发送规范名称或原生名称之一,不要同时发送两者。 规范名称
prompt必填
reference_image_urls可选
images
reference_video_urls可选
reference_audio_urls可选
image_url可选
image
middle_image_url可选
middle_frame_time可选
end_image_url可选
end_image
duration可选
resolution可选
seed可选
enable_safety_checker可选
prompt_expansion_mode必填
aspect_ratio可选
reference_conditions可选
reference_conditions[].type必填
reference_conditions[].url必填
文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件
输出
{
"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"
}
}
输出字段
- video
- object {url, content_type, file_name, file_size}模型生成的视频。
- expanded_prompt
- string | null适用于模型的扩展提示词;如果没有可用的扩展文本则为 null。出现 null 的情况包括禁用扩展、扩展未产生变化,以及扩展由模型托管的 API 内部处理。
- seed
- integer用于复现生成结果的基础种子。
- timings
- object | null以秒表示的计时数据,仅在报告后端计时的路由上可用;否则为 null。'inference' 条目表示 DiT 在 GPU 后端进行去噪所需的时间。
其他 Hailuo 03 New Turbo 变体
更多模型:参考图生成视频
对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh-CN/developers/models/minimax/h3-max/reference-to-video.md. 所有模型和指南: https://doitong.com/developers/llms.txt