MiniMax H3 API
AI VideoMiniMax H3, MiniMax'in OmniaKey üzerindeki video rotasıdır: tek bir model kimliği metinden videoya, isteğe bağlı son kareli ilk kareye ve referansla yönlendirilen çekimlere 768P veya 2K'da hizmet eder.
- Çıktı saniyesi başına$0,0269–$0,0431
- İşlemlerMetinden videoya
- Görselden videoya
- Referanstan video
- Araç fiyatlarını ve ücretlendirme kurallarını gör
Modeli çalıştırdığınızda sonucunuz burada görünecek.
01
Nerede işe yarar
MiniMax H3, MiniMax'in OmniaKey üzerindeki video rotasıdır: tek bir model kimliği metinden videoya, isteğe bağlı son kareli ilk kareye ve referansla yönlendirilen çekimlere 768P veya 2K'da hizmet eder.
Bir çekim sabit başlangıç ve bitiş karesi ya da referans görsel ve videolarla yönlendirilen hareket gerektiriyorsa MiniMax H3'ü seçin: 768P'de saniye başına $0.03, 2K'da $0.04. Yalnızca ses referansı reddedilir; yanına bir görsel veya video referansı ekleyin.
02
Neler yapar
Metinden videoya
minimax-h3
Metin isteminden kısa bir video klip üretir.
Görselden videoya
minimax-h3
Sabit bir görseli kısa bir videoya dönüştürür.
Referanstan video
minimax-h3
Klibi referans materyalle yönlendirir; bir karakteri, stili veya hareketi korur.
03
Ayrıntılar
MiniMax H3, Hailuo hattının güncel video modelidir; burada minimax-h3 olarak listelenir ve üç görev türünün tamamı için tek bir kimlik kullanılır: metin, görsel (isteğe bağlı son kare ile) ve referans video. MiniMax bunu 31 Temmuz 2026'da Hailuo 01 ve 02'nin ardından gelen nesil olarak duyurdu ve ad sayfaya göre değişiyor — API model açıklaması buna Hailuo-03 diyor.
768P veya 2K çözünürlükte üretir, 4 ile 15 arasında tam saniyelik süreler alır ve 21:9 bandı dahil yedi en-boy oranını kabul eder. Her klip stereo sesle gelir ve MiniMax'in create referansı sesi susturmak için bir anahtar listelemez, bu yüzden sessiz bir ana kopyanın sonradan ayıklanması gerekir.
Ekim 2026'daki denememiz her modda birer 5 saniyelik 768P iş çalıştırdı: üçü de H.264 MP4 olarak 24 fps, 5.17 saniye uzunluğunda ve stereo AAC ile döndü. İstem sesten hiç söz etmediğinde modelin ne uydurduğu da dahil olmak üzere gözlemler aşağıda.
Kendi müziğini taşıyan sahneler
H3, ortam sesini aksiyona uyacak şekilde yazar: hortum görünmeden hemen önce akan su, bisiklet sürüşü üzerinde piyano. Görsel cümlenin yanına bir ses cümlesi yazın, ikisi aynı vuruşta gelir; bu da kısa sosyal medya kesitlerinde bir foley aşamasından tasarruf sağlar.
Tek işte ilk ve son kare
Görsel işlemi bir first_frame ve isteğe bağlı bir last_frame alır, böylece bir plana nerede başlayacağı kadar nerede biteceği de söylenebilir. Bir sonraki sahneye geçişin ikinci bir render olmadan planlanması bu şekilde yapılır.
Referans ses ve video birlikte
Referans işlemi reference_image, reference_video ve reference_audio kabul eder; 768P işimiz aynı anda bir görsel, bir video ve bir ses dosyası taşıdı. Tek başına bir ses dosyasının reddedildiğini unutmayın: ses bir görüntüyle birlikte gitmek zorundadır.
04
Test notları
Metin, görsel ve referans modunda oluşturduğumuz üç MiniMax H3 klibi de H.264 MP4 dosyası olarak 24 fps, 5.17 saniye ve stereo AAC ses ile döndü.
Testi okuyunGörselden videoya işinde en-boy oranını tamamen dışarıda bıraktık ve MiniMax H3 karenin kendi şeklini koruyup 1376x768 bir klip döndürdü.
Testi okuyunMiniMax H3 istemlerimiz sesten hiç söz etmediğinde model robot klibi için su, bisiklet klibi için piyano ekledi.
Testi okuyun16 Eylül 2026'daki kısa denememiz, 768P'de bir görsel, bir video ve bir ses referansını birlikte taşıyan bir MiniMax H3 referanstan videoya işini tamamladı.
Bir MiniMax H3 referans işini yalnızca ses dosyasıyla, görsel veya video olmadan gönderdiğimizde istek bir görev başlatmak yerine başarısız oldu.
05
Planlanması gereken sınırlar
- Ses istekte kapatılamaz: create referansında hiçbir ses parametresi görünmez, bu yüzden sessiz bir klip tamamlanan dosyadan ayıklanmalıdır.
- Referans medya türleri karıştırılamaz. Kareler görsel işlemine, reference_image, reference_video ve reference_audio ise referans işlemine aittir ve yalnızca ses içeren bir iş doğrudan reddedilir.
- Base64 dahil tüm istek gövdesi 1 MiB ile sınırlıdır; bu yüzden betiğimiz 1024 piksel JPEG gönderdi; tam boy kareler görev oluşmadan başarısız olur.
- Yalnızca 768P ve 2K için fiyatlandırma vardır. 1080P veya 4K isteği küçültülmek yerine model fiyat hatasıyla reddedilir, bu yüzden kodda desteklenen bir boyut seçin.
06
Yakın modelleri karşılaştır
| Model | En uygun | İşlemler | Liste fiyatı |
|---|---|---|---|
| MiniMax H3Bu sayfa minimax-h3 | 768P veya 2K, 4 ile 15 saniye, stereo ses, ilk ve son kare, ses referansları. | Metinden videoya · Görselden videoya · Referanstan video | $0,0269–$0,0431 saniye başına |
| Wan 3.0 wan3.0-video | Daha düşük bir ücretle 480P taslaklar ve 30 saniyelik çekimler, kapatılabilen ses ile. | Metinden videoya · Görselden videoya · Referanstan video | $0,04–$0,16 saniye başına |
| HappyHorse 1.1 happyhorse-1.1 | Her işlem için ayrı bir kimlik gerektirir, en fazla 1080P'ye çıkar, ancak 480P katmanı ekler. | Metinden videoya · Görselden videoya · Referanstan video | $0,042–$0,108 saniye başına |
07
Kaynaklar ve doğrulama
Kılavuz 2026-10-27 tarihinde güncellendi.
08
Nasıl çağrılır
Medya modelleri eşzamansız çalışır: görevi oluşturun, tamamlanana kadar sorgulayın, ardından imzalı varlık URL'sini indirin.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: minimax-h3-001" \
-d '{
"model": "minimax-h3",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The same model id and the same poll loop serve the other operations:
# image_to_video media[] type "first_frame"
# reference_to_video media[] type "reference_image"
# Reference media travel alongside the prompt:
# {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
# A public HTTPS URL or a base64 data URI both work.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"09
Fiyatlandırma
Video işleri token başına değil, üretilen çıktının saniyesi başına faturalandırılır. Başarısız veya iptal edilen işler otomatik iade edilir.
$0,0269–$0,0431saniye başına%82 tasarruf
- 768P
- $0,0269saniye başına
- 2K
- $0,0431saniye başına
İlgili makaleler
Clapping Cat Meme AI: Evcil hayvanınızı görselden videoya ile alkışlatın
Tek fotoğraf, tek prompt, üç model: üçü de kediyi oturttu ve alkışlattı, ama ağız ve filigran farklıydı.
Makaleyi okuMiniMax H3 prompt rehberi: yapı, örnekler ve gerçek klipler
Yedi prompt ve yedi gerçek klip: hangi kesmeler zamanında geldi, ses alanları ne yapıyor ve hangi tabelalarda yazı okunmaz çıktı.
Makaleyi okuHailuo API: Python ile MiniMax H3 rehberi ve 3 video modu testi
Tek betik, üç mod: görevi oluştur, durumunu sor, MP4 dosyasını indir. Her klip sesiyle birlikte geldi.
Makaleyi okuSık sorulan sorular
MiniMax H3 modelini OmniaKey üzerinde nasıl çağırırım?
Model kimliği, type "video" ve operation "text_to_video" ile /v1/media/tasks adresine POST gönderin; ilk kareden üretmek için operation'ı "image_to_video" yapıp kareyi input.media[] (type "first_frame") içine koyun. Yeniden denemelerde aynı Idempotency-Key değerini kullanın; böylece bir zaman aşımı ikinci bir ücretli iş başlatmaz.
MiniMax H3 ne kadar?
MiniMax H3, üretilen video için $0,0269–$0,0431 saniye başına olarak faturalandırılır. Oluşturma sırasında istenen süre ön ödemeli bakiyenizden ön tahsil edilir; başarısız veya iptal edilen işler otomatik iade edilir.
API neden video yerine bir görev kimliği döndürüyor?
Video oluşturma yaklaşık bir dakikadan birkaç dakikaya kadar sürer; bu yüzden OmniaKey tüm video rotalarını tek bir eşzamansız akıştan geçirir. Durum succeeded olana kadar GET /v1/media/tasks/{id} adresini sorgulayın, sonra imzalı varlık URL'sini okuyun.
Bir MiniMax H3 klibi ne kadar uzun olabilir?
4 ile 15 tam saniye arası, duration ile ayarlanır. Kesirli değerler aralığın parçası değildir, bu yüzden kesitleri tam saniye olarak planlayın. İşlerimiz 5 istedi ve 5.17 saniyede döndü; bu fazladan görüntü değil, normal kapsayıcı dolgusudur.
Sesi kapatabilir miyim?
İstek üzerinden hayır. MiniMax'in create referansı H3 için hiçbir ses anahtarı listelemez ve istem sesten hiç söz etmese bile kliplerimizin tümü stereo AAC izi taşıdı. Bir müşteri sessizlik istiyorsa sesi kurguda veya indirmede ayıklayın.
Yalnızca ses referansı gönderirsem ne olur?
İstek bir görev oluşturulmadan reddedilir. Referans ses, bir referans görsel veya referans video ile birlikte gitmek zorundadır; belgelerin belirttiği kural budur ve yalnızca ses içeren işimizin karşılaştığı durum da budur. Aynı işe bir görüntü ekleyin, işlem devam eder.
Karemin şeklini koruyor mu?
Evet, bir görsel işinde aspect_ratio dışarıda bırakıldığında. 1376x768 dosyamız 16:9'a doldurulmak yerine kareyi izledi ve MiniMax, görsel işleminin görüntüyü izlediğini, metnin ise sabit bir oran gerektirdiğini belgeler. Kareyi dağıtım şeklinde oluşturun.
Hangi çözünürlükleri bütçelemeliyim?
768P veya 2K. 1080P veya 4K isteği model fiyat hatası olarak döner, çünkü H3'te böyle bir katman yoktur; başka bir modelden boyut devralan bir betik burada başarısız olur. Kendi işlerimizin tümü 768P'de çalıştı; buna bağlı bir oturumdan önce 2K'yı bir kez test edin.
