MiniMax H3 API
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.
- Model kimliği
- minimax-h3
- Sağlayıcı
- MiniMax
- Tür
- AI Video
- Çıktı saniyesi başına
- $0,15–$0,30
- Son doğrulama
- 2026-09-16
01
Nerede işe yarar
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.15, 2K'da $0.30. 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.
Referans video
minimax-h3
Üretilen klibi yönlendirmek için referans görüntü kullanır.
03
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)"04
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,15–$0,30saniye başına
- 768P
- $0,15saniye başına
- 2K
- $0,30saniye başına
Sı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,15–$0,30 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.
