Kullanıma açık

MiniMax H3 Max: referanslardan video

Geliştiren: MiniMax

Metinden yeni bir video oluştur veya elindeki fotoğrafı hareketlendir. Mevcut bir klibi değiştirmek için ilgili video düzenleme işlemini seç; her işlem kendi model kimliğini kullanır.

Model kimliği
Geliştiren
MiniMax

Model kimliği

Her istekte bunu kullan
minimax/h3-max/reference-to-video

Bu modelin kendi kimliği olan başka modları da var: minimax/h3-max/text-to-video, minimax/h3-max/image-to-video, minimax/h3-max/camera-controls, minimax/h3-max/lip-sync/image-to-video, minimax/h3-max/extend-video, minimax/h3-max/3d-to-video, minimax/h3-max/relight.

Çalıştır

Girdiye ücret teklifi al, bu teklifle üretimi başlat, ardından işin durumunu sorgula. Önce RAYWAKE_API_KEY değişkenini ayarla; ayrıntılar için Kimlik doğrulama sayfasına bak.

# 1. Göndereceğin girdi için ücret teklifi al; teklif en fazla 10 dakika geçerlidir.
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/h3-max/reference-to-video",
  "input": {
    "prompt": "Image 1'\''deki kadın Image 2'\''deki kafe masasına oturuyor, bir fincan çay dolduruyor, sonra başını kaldırıp kameraya gülümsüyor.",
    "prompt_expansion_mode": "balanced"
  }
}'

# 2. İlk adımdaki quote_id ile üretimi başlat.
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "minimax/h3-max/reference-to-video", "quote_id": "QUOTE_ID", "input": {"prompt":"Image 1'\''deki kadın Image 2'\''deki kafe masasına oturuyor, bir fincan çay dolduruyor, sonra başını kaldırıp kameraya gülümsüyor.","prompt_expansion_mode":"balanced"}}'

# 3. Üretimin durumunu sorgula; son duruma ulaşmadıysa bu sorguyu tekrarla.
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Girdi

minimax/h3-max/reference-to-video girdi alanları
AlanTürAçıklama
promptzorunlustring
Videoyu anlatan komut. Komutta referansları türleri ve listedeki sıralarıyla belirt: Image 1, Image 2, Video 1, Audio 1 gibi.
reference_image_urlsarray of image URLs
Özne ya da stil için referans görseller; komutta Image 1, Image 2 diye anılır. Referans görsel, video ve ses dosyaları toplamda en fazla 12 olabilir.
target_audio_urlstring (URL)
Videonun ses kanalı olarak kullanılacak, en az 2 saniyelik isteğe bağlı bir ses dosyası (en fazla 15 MB). Referans sesle birlikte kullanılamaz. Uzun dosyanın baştan video süresi kadarı alınır, kısa dosyanın sonu sessizlikle tamamlanır. Ses 32 kHz stereoya çevrilir ve hızı değişmeden videonun ses kanalının yerini alır. HTTP(S) adresi ya da base64 data URI kabul edilir.
durationnumber
Videonun saniye cinsinden süresi. Çıktı istenenden 0,7 saniyeye kadar uzun olabilir. Hedef ses eklersen en az 2 saniye seç.

Varsayılan: 5

resolutionstring (enum)
Modelin doğrudan ürettiği çözünürlük; 1080P, 768P'de üretilen görüntünün iyileştirilmiş hâlidir.

Varsayılan: 768P

Seçenekler: 480P, 768P, 1080P

seedinteger
Seed. Boş bırakırsan rastgele bir seed seçilir.
sync_modeboolean
Eşzamanlı mod

Varsayılan: false

prompt_expansion_modezorunlustring (enum)
Üretimden önce komutu yeniden yazmaya ne kadar emek harcanacağı. 'disabled' komut genişletmeyi atlar. 'balanced' yaklaşık bir saniyede döner. 'quality' daha zengin bir komut için ~30 saniyeye kadar harcar.

Varsayılan: balanced

Seçenekler: balanced

aspect_ratiostring (enum)
Üretilecek videonun en-boy oranı.

Varsayılan: adaptive

Seçenekler: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

Çıktı

Başarılı bir iş, sonuçlarını outputs altında listeler; dosyalar bizim tarafımızda saklanır. Tüm alanlar için İşler sayfasına bak.

İş yanıtından bir bölüm
"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Fiyatlandırma

  • en fazla, varsayılan ayarlar$0,64/ üretim

Girdinin kesin ücreti ücret teklifinden gelir. Bakiye nasıl kesinleşir?

API belgeleri

Model hakkında

Genel bakış

MiniMax H3 Max yazdığın sahneyi en fazla 15 saniyelik bir videoya dönüştürür. Çözünürlük 480P, 768P ya da 1080P olabilir; 21:9'dan 9:16'ya altı en-boy oranı var. Üretimden önce kısa bir komutu daha ayrıntılı hâle getirebilir; bunun için ne kadar uğraşacağını sen seçersin ya da kapatırsın.

Aynı ailede yalnızca metinden üretim yok: fotoğraf hareketlendirebilir, kamerayı yönetebilir, mevcut bir klibe yeni bir şey ekleyebilir, klibi uzatabilir ya da 3D bir sahneyi videoya çevirebilirsin. Her modun kendi sayfası ve formu var. İstersen kendi ses dosyanı videonun sesi olarak kullanabilirsin.

Neler yapabilirsin

  • Yazdığın bir tariften reklam ve sosyal medya videoları
  • Bir ürün fotoğrafının ya da çizimin hareketli hâli
  • Durağan bir görselde yaklaşma ya da etrafında dönme gibi seçtiğin kamera hareketleri
  • Elindeki klibi uzatarak daha uzun sahneler
  • Kendi seslendirmene ya da müziğine göre zamanlanmış videolar

Komut ipuçları

  • Komutunun olduğu gibi uygulanmasını istiyorsan komut genişletmeyi kapat; tek satırlık bir fikirde açık bırak.
  • Kamerayı sahnenin bir parçası gibi anlat: nereden başlıyor, hangi yöne ve ne hızla gidiyor.
  • Kendi sesini eklediğinde videonun süresini sesin süresine yakın tut.
  • Bir klibin ışığını değiştirmek için sahnenin nasıl aydınlanmasını istiyorsan öyle aydınlatılmış bir küre görseli yükle; sonuç klibinle aynı uzunlukta olur.

Neleri kontrol etmelisin?

Klibin tamamını izle ve sesi dinle. Tekerlekleri, vücut hareketlerini, arka planın sürekliliğini ve varsa konuşmayı kontrol et. Başka bir işlemle karşılaştırırken kaynak girdiyi ve seçtiğin ayarları sakla.

Girdiler

  • Komut (zorunlu): Videoyu anlatan komut. Komutta referansları türleri ve listedeki sıralarıyla belirt: Image 1, Image 2, Video 1, Audio 1 gibi.
  • Referans görseller (isteğe bağlı): Özne ya da stil için referans görseller; komutta Image 1, Image 2 diye anılır. Referans görsel, video ve ses dosyaları toplamda en fazla 12 olabilir.
  • Hedef ses (isteğe bağlı): Videonun ses kanalı olarak kullanılacak, en az 2 saniyelik isteğe bağlı bir ses dosyası (en fazla 15 MB). Referans sesle birlikte kullanılamaz. Uzun dosyanın baştan video süresi kadarı alınır, kısa dosyanın sonu sessizlikle tamamlanır. Ses 32 kHz stereoya çevrilir ve hızı değişmeden videonun ses kanalının yerini alır. HTTP(S) adresi ya da base64 data URI kabul edilir.
  • Süre (isteğe bağlı): Videonun saniye cinsinden süresi. Çıktı istenenden 0,7 saniyeye kadar uzun olabilir. Hedef ses eklersen en az 2 saniye seç. 0.92 ile 15 arası.
  • Çözünürlük (isteğe bağlı): Modelin doğrudan ürettiği çözünürlük; 1080P, 768P'de üretilen görüntünün iyileştirilmiş hâlidir. Seçenekler: 480P, 768P, 1080P.
  • Seed (isteğe bağlı): Seed. Boş bırakırsan rastgele bir seed seçilir.
  • En-boy oranı (isteğe bağlı): Üretilecek videonun en-boy oranı. Seçenekler: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Çıktı ve sınırlar

  • Süre: 0.92 saniye ile 15 saniye arası.
  • Çözünürlük: 480P, 768P, 1080P.
  • En-boy oranı: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • Videodaki yazılar, özellikle küçük olanlar, doğru çıkmayabilir.
  • Birbiriyle etkileşen birkaç karakterin olduğu sahnelerde tutarlılık bozulabilir.
  • Video uzadıkça hareket kayabilir ya da sahne beklenmedik biçimde değişebilir.
  • Kalitesiz girdiler bozulmaya yol açar: çok sıkıştırılmış dosyalar, kolajlar, ekran görüntüleri ve üstüne yazı eklenmiş görseller.
  • Bazı komutlar ya da sonuçlar güvenlik kontrolüne takılabilir.

Fiyat rehberi

  • en fazla, varsayılan ayarlar: $0,64 / üretim