İçeriğe geç

H3 Max Reference to Video

Entegre et

Model kimliği 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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Örnekteki gibi dosyalar: $0,40 400 API kredisi dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

API anahtarı al
MiniMax Referanstan Videoya Referans girdileri0,92–15 s1080P değerine kadar #stylized#transform#typography

Referans görüntüleri, videoları ve ses kliplerini kullanarak öznelerin tutarlılığını koruyan H3 Max video oluşturma

MiniMax · Video

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli 88 / 50000

Referansları varlık türü ve her referans listesindeki konumuyla tanımlayan video üretim talimatları; Audio 1, Video 1, Image 1, Image 2 gibi etiketler kullanılır.

•gerekli

Üretim öncesi istem yeniden yazma çabası: 'quality', yaklaşık 30 saniyeye kadar daha zengin bir istem geliştirirken 'balanced' yaklaşık bir saniyede sonuç döndürür. İstem genişletmeyi atlamak için 'disabled' seçin.

resolution varsayılan 768P

Üretim çözünürlüğü seçimi: 1080P, seçilen çözünürlükte yerel üretim yerine 768P'de yerel olarak üretilen materyalin gizil iyileştirilmesini gerektirir.

aspect_ratio varsayılan adaptive

Çıktı videosunun en-boy oranı.

varsayılan 5

Saniye cinsinden istenen süre; gerçek video uzunluğunun bu isteğin yaklaşık 0.7 saniye üzerine çıkmasına izin verir.

Gelişmiş 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
Dosyayı bırakın veya · 9 adede kadar

Konu veya stil referansı görsel URL'leri; tüm video ve ses referanslarıyla birlikte 12 dosyalık ortak sınırı paylaşır. Bu görselleri istemde liste konumuyla Image 1, Image 2 ve sonraki etiketleri kullanarak tanımlayın.

Dosyayı bırakın veya · 3 adede kadar

İstemde liste konumuyla Video 1, Video 2 ve sonraki etiketler kullanılarak tanımlanan hareket veya diğer referans video URL'leri. Görsel, video ve ses referansları arasındaki ortak sınır 12 dosyadır; video kliplerinin her biri 2–15 saniye sürmeli ve toplamda 15 saniyeyi aşmamalıdır.

Dosyayı bırakın veya · 3 adede kadar

Referans sesi URL'ler olarak sağlayın ve istemde klipleri Audio 1, Audio 2 ve sonraki etiketleri kullanarak tanımlayın. Her klip 2–15 saniye uzunluğunda olmalı ve toplam ses süresi 15 saniyeyi aşmamalıdır. Görsel, video ve ses referans türlerinden herhangi biri tek başına veya birlikte sağlanabilir; ortak üst sınır 12 dosyadır.

image_url
Dosyayı bırakın veya

Tam açılış karesini tanımlayan ve çıktı tuvalini belirleyen isteğe bağlı görsel URL'si. Referans varlıkları konu tutarlılığını korur.

Dosyayı bırakın veya

Yalnızca yerel 480P veya 768P üretiminde ve hem başlangıç hem bitiş görseli sağlandığında kullanılabilen, middle_frame_time için isteğe bağlı kılavuz görsel.

end_image_url
Dosyayı bırakın veya

Videonun tam son karesini sağlanan görsele sabitleyen isteğe bağlı son görsel URL'si.

Yalnızca middle_image_url ile kullanılabilen ve istenen videonun ilk ve son karelerinin tam arasındaki konumlarla sınırlı orta görsel yerleştirme zamanı. Başlangıçtan itibaren geçen saniyeleri sağlayın; değer en yakın 24 fps karesine yuvarlanır.

Rastgele üretim için tohum; belirtilmezse rastgele bir tane seçilir.

reference_*_urls yerine alternatif olarak sağlanan referans listesi; bunlarla birlikte kullanılamaz. Modlar arasındaki sıralama anlam taşır, bu nedenle işleme boyunca korunur.

POST /run/minimax/h3-max/reference-to-video?wait=20 fiyat → $0,40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

H3 Max Reference to Video hakkında

Referans varlıkların yönlendirdiği video oluşturur: en fazla 9 görüntü, 3 video ve 3 ses klibi; toplamda en fazla 12 dosya. İstem bunlara Image 1, Video 1, Audio 1 şeklinde atıfta bulunur. İsteğe bağlı ilk, orta (`middle_image_url` ile `middle_frame_time`) ve son kareler başlangıcı, ortayı ve sonu sabitler. `duration` 0.92 ile 15 saniye arasındadır ve `aspect_ratio` adaptive olabilir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
promptgerekli
Türstring
≤ 50.000 karakter
Referansları varlık türü ve her referans listesindeki konumuyla tanımlayan video üretim talimatları; Audio 1, Video 1, Image 1, Image 2 gibi etiketler kullanılır.
reference_image_urlsisteğe bağlı images
Türurl[] · image
≤ 9 öğe
Konu veya stil referansı görsel URL'leri; tüm video ve ses referanslarıyla birlikte 12 dosyalık ortak sınırı paylaşır. Bu görselleri istemde liste konumuyla Image 1, Image 2 ve sonraki etiketleri kullanarak tanımlayın.
reference_video_urlsisteğe bağlı
Türurl[] · video
≤ 3 öğe
İstemde liste konumuyla Video 1, Video 2 ve sonraki etiketler kullanılarak tanımlanan hareket veya diğer referans video URL'leri. Görsel, video ve ses referansları arasındaki ortak sınır 12 dosyadır; video kliplerinin her biri 2–15 saniye sürmeli ve toplamda 15 saniyeyi aşmamalıdır.
reference_audio_urlsisteğe bağlı
Türurl[] · audio
≤ 3 öğe
Referans sesi URL'ler olarak sağlayın ve istemde klipleri Audio 1, Audio 2 ve sonraki etiketleri kullanarak tanımlayın. Her klip 2–15 saniye uzunluğunda olmalı ve toplam ses süresi 15 saniyeyi aşmamalıdır. Görsel, video ve ses referans türlerinden herhangi biri tek başına veya birlikte sağlanabilir; ortak üst sınır 12 dosyadır.
image_urlisteğe bağlı image
Türurl · image
Tam açılış karesini tanımlayan ve çıktı tuvalini belirleyen isteğe bağlı görsel URL'si. Referans varlıkları konu tutarlılığını korur.
middle_image_urlisteğe bağlı
Türurl · image
Yalnızca yerel 480P veya 768P üretiminde ve hem başlangıç hem bitiş görseli sağlandığında kullanılabilen, middle_frame_time için isteğe bağlı kılavuz görsel.
middle_frame_timeisteğe bağlı
Türnumber | null
> 0< 15
Yalnızca middle_image_url ile kullanılabilen ve istenen videonun ilk ve son karelerinin tam arasındaki konumlarla sınırlı orta görsel yerleştirme zamanı. Başlangıçtan itibaren geçen saniyeleri sağlayın; değer en yakın 24 fps karesine yuvarlanır.
end_image_urlisteğe bağlı end_image
Türurl · image
Videonun tam son karesini sağlanan görsele sabitleyen isteğe bağlı son görsel URL'si.
durationisteğe bağlı
Türnumber
Varsayılan5
0,92 – 15
Saniye cinsinden istenen süre; gerçek video uzunluğunun bu isteğin yaklaşık 0.7 saniye üzerine çıkmasına izin verir.
resolutionisteğe bağlı
Türenum
Varsayılan768P
480P768P1080P
Üretim çözünürlüğü seçimi: 1080P, seçilen çözünürlükte yerel üretim yerine 768P'de yerel olarak üretilen materyalin gizil iyileştirilmesini gerektirir.
seedisteğe bağlı
Türinteger | null
Rastgele üretim için tohum; belirtilmezse rastgele bir tane seçilir.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Güvenlik denetleyicisi etkinleştirme; true denetimi etkinleştirir.
prompt_expansion_modegerekli
Türstring
Varsayılanbalanced
Üretim öncesi istem yeniden yazma çabası: 'quality', yaklaşık 30 saniyeye kadar daha zengin bir istem geliştirirken 'balanced' yaklaşık bir saniyede sonuç döndürür. İstem genişletmeyi atlamak için 'disabled' seçin.
aspect_ratioisteğe bağlı
Türenum
Varsayılanadaptive
adaptive21:916:94:31:13:49:16
Çıktı videosunun en-boy oranı.
reference_conditionsisteğe bağlı
Türobject[]
≤ 12 öğe
reference_*_urls yerine alternatif olarak sağlanan referans listesi; bunlarla birlikte kullanılamaz. Modlar arasındaki sıralama anlam taşır, bu nedenle işleme boyunca korunur.
reference_conditions[].typegerekli
Türenum
imagevideoaudio
Referansın modu; listedeki modlar arasındaki sıralama anlam taşır.
reference_conditions[].urlgerekli
Türstring
≥ 1 characters
Referans medyasının URL'si.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
video
object {url, content_type, file_name, file_size}Model tarafından üretilen video.
expanded_prompt
string | nullModel için hazır genişletilmiş istem veya genişletilmiş metin yoksa null. null durumları genişletmenin devre dışı olması, genişletmenin değişiklik yapmaması ve genişletmenin modelin barındırılan API'si tarafından dahili olarak işlenmesidir.
seed
integerÜretilen sonucu yeniden oluşturmak için kullanılan temel tohum.
timings
object | nullSaniye cinsinden ifade edilen zamanlama ölçümleri; yalnızca arka uç zamanlamalarını raporlayan rotalarda kullanılabilir, aksi halde null. 'inference' girdisi, DiT gürültü giderme işleminin GPU arka ucunda ne kadar sürdüğünü ölçer.

Daha fazla model: Referanstan Videoya

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/minimax/h3-max/reference-to-video.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt