Bỏ qua đến nội dung

H3 Max Reference to Video

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,40 $ 400 tín dụng API · ≈ 42,63 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API

Được tạo trên Doitong

Các tác phẩm công khai được cộng đồng Doitong tạo bằng Hailuo 03 New Turbo. Tái sử dụng một lời nhắc chỉ với một lần nhấp.

Tác phẩm công khai được hiển thị: 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, тёплая кинематографичная ночная сцена в спальне. Полностью сохранить лица Ани и Павла, их внешность, причёски, одежду, освещение, кровать, панорамные окна и ночной город. Камера статичная, средний крупный план....

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc 88 / 50000

Hướng dẫn tạo video với các tham chiếu được xác định theo loại tài sản và vị trí trong từng danh sách tham chiếu, dùng các nhãn như Audio 1, Video 1, Image 1, Image 2, v.v.

•bắt buộc

Mức độ viết lại lời nhắc trước khi tạo sinh: 'quality' phát triển lời nhắc phong phú hơn trong khoảng tối đa khoảng 30s, còn 'balanced' trả về trong khoảng một giây. Chọn 'disabled' để bỏ qua việc mở rộng lời nhắc.

resolution mặc định 768P

Lựa chọn độ phân giải tạo sinh: 1080P yêu cầu tinh chỉnh latent của nội dung được tạo gốc ở 768P, thay vì tạo gốc ở độ phân giải đã chọn.

aspect_ratio mặc định adaptive

Tỷ lệ khung hình của video đầu ra.

mặc định 5

Thời lượng yêu cầu tính bằng giây, cho phép video thực tế dài hơn yêu cầu khoảng tối đa 0.7 s.

Nâng cao 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
Thả tệp hoặc · tối đa 9

URL hình ảnh tham chiếu chủ thể hoặc phong cách, dùng chung giới hạn tối đa 12 tệp với tất cả tham chiếu video và âm thanh. Xác định các hình ảnh này trong lời nhắc theo vị trí trong danh sách bằng Image 1, Image 2 và các nhãn tiếp theo.

Thả tệp hoặc · tối đa 3

URL video tham chiếu chuyển động hoặc thành phần khác, được xác định trong lời nhắc theo vị trí danh sách bằng Video 1, Video 2 và các nhãn tiếp theo. Giới hạn dùng chung cho tham chiếu hình ảnh, video và âm thanh là 12 tệp; mỗi đoạn video phải dài 2–15 giây và tổng thời lượng không quá 15 giây.

Thả tệp hoặc · tối đa 3

Cung cấp âm thanh tham chiếu dưới dạng URL và xác định các đoạn trong lời nhắc bằng Audio 1, Audio 2 và các nhãn tiếp theo. Mỗi đoạn phải dài 2–15 giây, tổng âm thanh không quá 15 giây. Có thể cung cấp riêng hoặc kết hợp bất kỳ loại tham chiếu hình ảnh, video và âm thanh nào, với giới hạn chung tối đa 12 tệp.

image_url
Thả tệp hoặc

URL hình ảnh tùy chọn xác định chính xác khung hình mở đầu và canvas đầu ra. Các tài sản tham chiếu duy trì tính nhất quán của chủ thể.

Thả tệp hoặc

Hình ảnh hướng dẫn tùy chọn cho middle_frame_time, chỉ khả dụng với tạo sinh gốc 480P hoặc 768P và khi đã cung cấp cả hình ảnh bắt đầu lẫn kết thúc.

end_image_url
Thả tệp hoặc

URL hình ảnh cuối tùy chọn, cố định khung hình kết thúc chính xác của video thành hình ảnh được cung cấp.

Thời điểm đặt hình ảnh giữa, chỉ dùng được với middle_image_url và bị giới hạn ở vị trí nằm hoàn toàn giữa khung hình đầu và cuối của video yêu cầu. Cung cấp số giây đã trôi qua từ lúc bắt đầu; giá trị được làm tròn đến khung hình gần nhất ở 24 fps.

Seed dùng cho tạo sinh ngẫu nhiên; nếu bỏ qua, một seed sẽ được chọn ngẫu nhiên.

Danh sách tham chiếu được cung cấp thay cho reference_*_urls, không bao giờ dùng cùng chúng. Thứ tự giữa các phương thức mang ý nghĩa, vì vậy trình tự được duy trì trong suốt quá trình xử lý.

POST /run/minimax/h3-max/reference-to-video?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về H3 Max Reference to Video

Tạo video theo các tài nguyên tham chiếu: tối đa 9 hình ảnh, 3 video và 3 đoạn âm thanh, tổng cộng không quá 12 tệp. Lời nhắc gọi chúng là Image 1, Video 1, Audio 1, v.v. Có thể tùy chọn ghim khung hình đầu, giữa (`middle_image_url` tại `middle_frame_time`) và cuối để xác định phần đầu, giữa và cuối. `duration` là 0.92 đến 15 giây, còn `aspect_ratio` có thể là adaptive.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 50.000 ký tự
Hướng dẫn tạo video với các tham chiếu được xác định theo loại tài sản và vị trí trong từng danh sách tham chiếu, dùng các nhãn như Audio 1, Video 1, Image 1, Image 2, v.v.
reference_image_urlstùy chọn images
Kiểuurl[] · image
≤ 9 mục
URL hình ảnh tham chiếu chủ thể hoặc phong cách, dùng chung giới hạn tối đa 12 tệp với tất cả tham chiếu video và âm thanh. Xác định các hình ảnh này trong lời nhắc theo vị trí trong danh sách bằng Image 1, Image 2 và các nhãn tiếp theo.
reference_video_urlstùy chọn
Kiểuurl[] · video
≤ 3 mục
URL video tham chiếu chuyển động hoặc thành phần khác, được xác định trong lời nhắc theo vị trí danh sách bằng Video 1, Video 2 và các nhãn tiếp theo. Giới hạn dùng chung cho tham chiếu hình ảnh, video và âm thanh là 12 tệp; mỗi đoạn video phải dài 2–15 giây và tổng thời lượng không quá 15 giây.
reference_audio_urlstùy chọn
Kiểuurl[] · audio
≤ 3 mục
Cung cấp âm thanh tham chiếu dưới dạng URL và xác định các đoạn trong lời nhắc bằng Audio 1, Audio 2 và các nhãn tiếp theo. Mỗi đoạn phải dài 2–15 giây, tổng âm thanh không quá 15 giây. Có thể cung cấp riêng hoặc kết hợp bất kỳ loại tham chiếu hình ảnh, video và âm thanh nào, với giới hạn chung tối đa 12 tệp.
image_urltùy chọn image
Kiểuurl · image
URL hình ảnh tùy chọn xác định chính xác khung hình mở đầu và canvas đầu ra. Các tài sản tham chiếu duy trì tính nhất quán của chủ thể.
middle_image_urltùy chọn
Kiểuurl · image
Hình ảnh hướng dẫn tùy chọn cho middle_frame_time, chỉ khả dụng với tạo sinh gốc 480P hoặc 768P và khi đã cung cấp cả hình ảnh bắt đầu lẫn kết thúc.
middle_frame_timetùy chọn
Kiểunumber | null
> 0< 15
Thời điểm đặt hình ảnh giữa, chỉ dùng được với middle_image_url và bị giới hạn ở vị trí nằm hoàn toàn giữa khung hình đầu và cuối của video yêu cầu. Cung cấp số giây đã trôi qua từ lúc bắt đầu; giá trị được làm tròn đến khung hình gần nhất ở 24 fps.
end_image_urltùy chọn end_image
Kiểuurl · image
URL hình ảnh cuối tùy chọn, cố định khung hình kết thúc chính xác của video thành hình ảnh được cung cấp.
durationtùy chọn
Kiểunumber
Mặc định5
0,92 – 15
Thời lượng yêu cầu tính bằng giây, cho phép video thực tế dài hơn yêu cầu khoảng tối đa 0.7 s.
resolutiontùy chọn
Kiểuenum
Mặc định768P
480P768P1080P
Lựa chọn độ phân giải tạo sinh: 1080P yêu cầu tinh chỉnh latent của nội dung được tạo gốc ở 768P, thay vì tạo gốc ở độ phân giải đã chọn.
seedtùy chọn
Kiểuinteger | null
Seed dùng cho tạo sinh ngẫu nhiên; nếu bỏ qua, một seed sẽ được chọn ngẫu nhiên.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Kích hoạt trình kiểm tra an toàn; true bật kiểm tra.
prompt_expansion_modebắt buộc
Kiểustring
Mặc địnhbalanced
Mức độ viết lại lời nhắc trước khi tạo sinh: 'quality' phát triển lời nhắc phong phú hơn trong khoảng tối đa khoảng 30s, còn 'balanced' trả về trong khoảng một giây. Chọn 'disabled' để bỏ qua việc mở rộng lời nhắc.
aspect_ratiotùy chọn
Kiểuenum
Mặc địnhadaptive
adaptive21:916:94:31:13:49:16
Tỷ lệ khung hình của video đầu ra.
reference_conditionstùy chọn
Kiểuobject[]
≤ 12 mục
Danh sách tham chiếu được cung cấp thay cho reference_*_urls, không bao giờ dùng cùng chúng. Thứ tự giữa các phương thức mang ý nghĩa, vì vậy trình tự được duy trì trong suốt quá trình xử lý.
reference_conditions[].typebắt buộc
Kiểuenum
imagevideoaudio
Phương thức của tham chiếu; thứ tự giữa các phương thức trong danh sách mang ý nghĩa.
reference_conditions[].urlbắt buộc
Kiểustring
≥ 1 characters
URL của nội dung tham chiếu.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video do mô hình tạo ra.
expanded_prompt
string | nullLời nhắc mở rộng sẵn sàng cho mô hình hoặc null nếu không có văn bản mở rộng. Các trường hợp null gồm mở rộng bị tắt, mở rộng không tạo ra thay đổi và mở rộng được xử lý nội bộ bởi API được lưu trữ của mô hình.
seed
integerSeed cơ sở dùng để tái tạo kết quả đã tạo.
timings
object | nullCác phép đo thời gian được biểu thị bằng giây, chỉ khả dụng trên các tuyến báo cáo thời gian backend; nếu không thì là null. Mục 'inference' đo thời gian khử nhiễu DiT trên backend GPU.

Thêm mô hình: Tham chiếu sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/minimax/h3-max/reference-to-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt