Hiçbir şey entegre etmen gerekmiyorsa ve sadece video istiyorsan, mühendislik kısmını atlayabilirsin: stüdyomuz aynı modeli yükleme doğrulaması, tarayıcıdan kayıt, depolama ve indirmelerle birlikte sunuyor.
Bir OmniHuman 2 API isteği neler içerir
Bir istekte iki zorunlu alan ve bir isteğe bağlı alan bulunur. Görsel URL’si canlandırılacak kişiyi (ya da kişileri) gösterir; ses URL’si performansı yönetecek konuşmayı ya da şarkıyı gösterir; isteğe bağlı prompt ise hareketi, ruh halini, sahne detaylarını ve kamera hareketini tanımlar. Sonuçlar genellikle bir kuyruk üzerinden asenkron olarak iletilir: isteği gönderirsin, bir istek kimliği alırsın, ardından durumu sorgularsın ya da video hazır olduğunda bir webhook alırsın.
- image_url — zorunlu; canlandırılacak sabit görsel.
- audio_url — zorunlu; uzunluğu ve dudak senkronizasyonunu belirleyen MP3 ya da WAV.
- prompt — isteğe bağlı; İngilizce, Çince, Japonca, Korece, İspanyolca (Meksika) ve Endonezce desteklenir.
Önce doğrulaman gereken girdi sınırları
Reddedilen istekler zaman ve bazen para kaybettirir; bu yüzden modeli çağırmadan önce kendi tarafında doğrulama yap. Görsel JPEG, PNG, WEBP, BMP, TIFF, GIF ya da HEIC gibi yaygın bir formatta, en fazla 30 MB, her kenarda 300 ile 6000 piksel arasında ve genişlik-yükseklik oranı 0,4 ile 2,5 arasında olmalı. Ses WAV ya da MP3 olmalı, en fazla 15 MB ve 4 ile 300 saniye arasında olmalı.
Tarayıcı kayıtları genellikle WebM ya da Opus formatındadır ve model bunları kabul etmez. Yüklemeden önce WAV ya da MP3’e dönüştür — stüdyomuz kayıtları 22,05 kHz mono WAV olarak yeniden kodlar; bu da beş dakikalık bir klibi boyut sınırının altında tutar.
Çıktı ve faturalandırma
Tamamlanan bir iş, bir video dosyası URL’si ve faturalandırmada kullanılan, girdi sesinin uzunluğuyla aynı olan süreyi döndürür. Çıktı yerel 720p MP4’tür. Sağlayıcı URL’lerinin süresi dolabilir; bu yüzden üretim sistemleri doğrudan sağlayıcıya bağlantı vermek yerine iş biter bitmez dosyayı kendi depolamalarına kopyalamalıdır.
Maliyet oluşturulan saniyeyle ölçeklendiği için ses süresini sunucuda ölç — tarayıcının gönderdiği süreye asla güvenme — ve eşzamanlı işler bakiyeyi aşamasın diye göndermeden önce maliyeti rezerve et.
Üretime hazır bir akış
Bu sitedeki her video için çalıştırdığımız düzen:
- 1Gizli depolamaya yükleKısa ömürlü imzalı yükleme URL’leri oluştur; kullanıcı fotoğraflarına asla uzun ömürlü herkese açık bağlantılar verme.
- 2Sunucu tarafında doğrulaHerhangi bir ücretlendirmeden önce ses süresini yeniden ölç ve iki dosyanın da var olduğunu doğrula.
- 3Önce rezerve et, sonra gönderKredileri atomik olarak rezerve et, işi gönder ve gönderim başarısız olursa otomatik iade yap.
- 4İdempotent şekilde sonlandırWebhook ya da sorgulamada sonucu al, MP4’ü sakla ve işi tam olarak bir kez tamamlandı olarak işaretle.
Kodsuz stüdyo ne zaman daha iyi seçenek
Yukarıdaki altyapıyı kurmak günlerce iş demek: depolama, doğrulama, kuyruklar, webhook’lar, yeniden denemeler ve faturalandırma. Hedefin bir ürün özelliği değil de içerikse, stüdyomuz tüm bunlar hazır halde aynı OmniHuman 2.0 çıktısını sunar. Kendimiz herkese açık bir API sunmuyoruz; bu site bitmiş video isteyen içerik üreticileri ve pazarlamacılar için tasarlandı.
Hataları ve yeniden denemeleri yönetmek
Her işi başarısız olabilecek bir şey olarak ele al: sağlayıcı bir girdiyi reddedebilir, yük altında zaman aşımına uğrayabilir ya da indirilemeyen bir sonuç döndürebilir. Her iş için bir durum sütunu (kuyrukta, çalışıyor, tamamlandı, başarısız) tut, yinelenen bir webhook iki kez işlenmesin diye sonlandırma adımını idempotent yap ve başarısızlıkta rezerve edilen bakiyeyi iade et.
Webhook kullansan bile yedek olarak sorgulama yap. Yerel geliştirme makineleri webhook alamaz ve üretimdeki webhook’lar zaman zaman gecikir.
- Kullanıcıya yanıt dönmeden önce sağlayıcının istek kimliğini kaydet.
- Girdi URL’lerini beklenen kuyruk süresinden daha uzun bir geçerlilik süresiyle yeniden imzala.
- Sağlayıcı hatalarını olduğu gibi logla; genellikle aşılan sınırı tam olarak belirtirler.
SSS
omnihuman2.ai herkese açık bir API sunuyor mu?
Hayır. Modeli içerik üreticileri için web stüdyosu üzerinden çalıştırıyoruz. Geliştiriciler OmniHuman 2’ye resmi model sağlayıcıları üzerinden erişebilir.
OmniHuman 2 API için maksimum ses süresi nedir?
300 saniye. Minimum 4 saniyedir ve dosya 15 MB’tan küçük bir MP3 ya da WAV olmalıdır.
API hangi çözünürlükte döndürüyor?
2.0 sürümü yerel olarak 720p’de oluşturur ve bir MP4 dosyası döndürür.
API senkron mu?
Genellikle hayır. İşler dakikalar sürer; bu yüzden sağlayıcılar sorgulama ya da webhook’lu bir kuyruk kullanır.
WebM kaydı gönderebilir miyim?
Doğrudan değil. Önce WAV ya da MP3’e dönüştür; çoğu tarayıcı kaydının yeniden kodlanması gerekir.
Kullanım nasıl faturalandırılıyor?
Girdi sesinin uzunluğuna eşit olan çıktı saniyesine göre.
Çıktı videoyu kendi depolamama kopyalamalı mıyım?
Evet. Sağlayıcı sonuç URL’lerinin süresi dolabilir; bu yüzden iş tamamlanır tamamlanmaz MP4’ü kendi depolamana indir.
Bir iş genellikle ne kadar sürer?
Klip uzunluğuna ve kuyruk yoğunluğuna bağlı. Kendi testimizde yaklaşık beş saniyelik bir klip baştan sona yaklaşık iki dakikada tamamlandı; bu yüzden arayüzünü saniyelere değil dakikalara göre tasarla.