Medya kılavuzları

Video Generation

Metin, görsel, ses veya mevcut kliplerden videolar oluşturun

Video oluşturma işlemi asenkrondur. POST /v1/videos/generations bir görev kimliği (task ID) ve genellikle bir poll_url döndürür. Hazır video oluşana kadar bu kimlikle GET /v1/tasks/{id} uç noktasını sorgulayın (poll).

Seçtiğiniz model tarafından kabul edilen görsel alanlarında herkese açık HTTP(S) URL'lerini veya desteklenen veri URL'lerini gönderin. Bu girdiler normal medya yolunu izler ve otomatik olarak yeniden kullanılabilir materyal kimlikleri oluşturmaz.

Açık bir materyal henüz hazırlanıyorsa, POST /v1/videos/generations isteği inactive_asset_ids ile birlikte 409 seedance_material_preparing hatası döndürür. Bu varlıkları ACTIVE durumuna gelene kadar sorgulayın, ardından aynı materyal kimlikleriyle tekrar deneyin. Eğer bir varlık FAILED durumundaysa, error_message kısmını inceleyin ve tekrar denemeden önce düzeltin veya yeniden içe aktarın.

Bir API Seçin

Yeni bir video entegrasyonu için /v1/videos/generations kullanın. Hali hazırda Volcengine content[] veya Action istekleri gönderen mevcut Seedance 2.0 istemcileri, bu formatı /api/v3 üzerinden kullanmaya devam edebilir. Her iki API de TokenLab Bearer anahtarı kullanır, ancak alanları ve durum değerleri farklıdır.

Ne Oluşturacağınızı Seçin

API'nin iş için doğru alanları doğrulayabilmesi adına operation değerini açıkça ayarlayın.

İşlem (Operation)Gerekli veya tipik girdiKullanım durumu
text-to-videopromptSadece metinden oluşturma
image-to-videoimage_url veya uyumlu imageBaşlangıç görselini canlandırma
reference-to-videoreference_images ve desteklenen modellerde isteğe bağlı video_urls / audio_urlsKimlik, stil veya varlık referanslarını koruma
start-end-to-videostart_image, end_imageİlk ve son kareleri kontrol etme
video-to-videovideo_url veya modele özel task_idMevcut bir klibi dönüştürme veya ölçeklendirme
motion-controlimage_url ve video_urlBir özneye hareket referansı uygulama
audio-to-videoaudio_urlSes ile koşullandırılmış video akışları
video-extensiontask_id, extend_at veya modele özel uzatma alanlarıOluşturulmuş bir videoyu devam ettirme

Bir Model Seçin

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \
  -H "Authorization: Bearer sk-your-api-key"

TokenLab tarafından döndürülen bir model kimliğini kullanın, ardından operation ile oluşturma türünü ve ilgili medya girdilerini seçin. Model kimliği olarak işlem adı kullanmayın.

reference_images, kling_elements, output_audio, duration, resolution veya aspect_ratio gibi özel alanlara güvenmeden önce seçilen modelin detaylarını okuyun.

Video Oluşturun

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "A calm cinematic shot of a cat walking through a sunlit garden",
    "resolution": "720p",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

İnternetten getirilebilecek medya dosyaları için https URL'lerini kullanın. Geçici URL'ler, TokenLab görevi oluşturana kadar geçerli kalmalıdır.

Modele Özel Alanlar

Ses davranışı, seçilen modele ve işleme bağlıdır. Bir video, ses seçici gösterilmese bile ses içerebilir. Bir seçiciyi atlamak, false göndermekten farklıdır.

  • veo3.1, veo3.1-fast ve veo3.1-lite her zaman ses üretir. output_audio parametresini atlayın veya true gönderin; false değeri reddedilir.
  • wan-2.6 ve wan-2.7 her zaman ses içerir. output_audio parametresini atlayın veya true gönderin. wan-3.0 ve wan-3.0-prime da her zaman ses içerir ve herhangi bir ses seçici kabul etmez.
  • hailuo-h3 yerel ses üretir ve sessize alma anahtarı yoktur. Model detaylarında listelenmeyen bir ses seçici göndermeyin.
  • viduq3-pro ve viduq3-turbo varsayılan olarak ses üretir; sessiz çıktı için output_audio: false (veya audio: false) gönderin. Seedance ve PixVerse modelleri output_audio kabul eder; varsayılana güvenmek yerine bunu açıkça gönderin. Bunu yalnızca listeleyen işlemler için kullanın.
  • audio_url / audio_urls girdi veya referans sesi sağlar. Bunlar ses çıkışı anahtarları değildir. Video düzenleme, hareket aktarımı ve stil aktarımı, girdi ses kaydını koruyabilir; kaynak sesi korumak, onu sessize almamak anlamına gelir.

İzin verilen değerler ve sese bağlı fiyatlar için model detaylarını kontrol edin. Bir model bunları listelediğinde, outputAudio, generate_audio takma adları ve audio boole değeri, birlikte kullanıldıklarında output_audio ile uyumlu olmalıdır. Bir model ailesindeki her sürümün veya işlemin aynı ses kontrollerini paylaştığını varsaymayın.

  • Seedance 2.0 ailesi için, 4K çıktı, Fast/Mini çözünürlük sınırları veya çok modlu referans girdilerini kullanmadan önce Seedance 2.0 video modelleri kılavuzunu okuyun.
  • grok-imagine-video video-to-video işlemi için prompt ve herkese açık HTTPS .mp4 formatında bir video_url gönderin. Önceki bir görevden elde edilen TokenLab .mp4 sonuç URL'si de çalışır. Bu işlem duration, resolution veya aspect_ratio seçicilerini kullanmaz.

PixVerse ve HappyHorse

ModelİşlemlerGirdilerÇözünürlükSüreSes seçici
pixverse-c1, pixverse-v6text-to-video, image-to-video, start-end-to-video, reference-to-videoprompt; image_url; start_image + end_image; reference_images360p, 540p, 720p, 1080p1 ile 15 saniye arasında herhangi bir tam sayıoutput_audio, varsayılan false
pixverse-v5.6text-to-video, image-to-video, start-end-to-video, reference-to-videoC1 ve V6 ile aynı alanlar360p, 540p, 720p, 1080p5, 8 veya 10 saniye; 1080p, 5 veya 8 saniyeyi destekleroutput_audio, varsayılan false
happyhorse-1.0text-to-video, image-to-video, reference-to-video, video-to-videoprompt; image_url; reference_images; video_url + reference_images720p, 1080pOluşturma işlemleri için 3 ila 15 saniye; video-to-video çıktısı 15 saniye ile sınırlıdıroutput_audio göndermeyin

TokenLab'de, yukarıdaki PixVerse modelleri operation=video-extension'ı kabul etmez.

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

Tamamlanan Videoyu Alın

Görev completed veya failed durumuna gelene kadar, oluşturma yanıtından gelen id veya task_id ile GET /v1/tasks/{id} uç noktasını çağırın.

Tamamlanan video görevleri, modele ve çıktı sayısına bağlı olarak video_url, video veya videos döndürebilir. billing_transaction_id değerini görev tanımlayıcısı olarak değil, faturalandırma tanımlayıcısı olarak değerlendirin.

Video sonuç URL'leri, .mp4 gibi dosya türüyle biten ve 30 gün boyunca geçerli kalan TokenLab medya sonuç URL'leridir. media_retention.items, her öğenin kaydetme durumunu ve expires_at bilgisini raporlar; kaydetme durumu zamanında bilinmediğinde yanıt media_retention alanını içermeyebilir ancak URL yine de çalışır. Başarısız olan ve devam eden görevler boş video URL alanları döndürür. Asenkron görev anlık görüntülerinin (snapshots) ayrı bir yaşam döngüsü vardır. Bkz: Veri saklama.

Yaygın Hatalar

  • Yeni kodlarda /v1/videos/generations/{id} gibi mod bazlı durum yollarını kullanmayın; GET /v1/tasks/{id} uç noktasını sorgulayın.
  • Model detayları izin vermediği sürece, ilk kare alanlarını özel referans görsel akışlarıyla birleştirmeyin.
  • duration değerinin girdi referans videosunun uzunluğunu belirttiğini varsaymayın; bu genellikle oluşturulan çıktının uzunluğunu kontrol eder.
  • POST /v1/videos/generations isteğiyle birlikte bir Idempotency-Key gönderin. Zaman aşımı durumunda, orijinal görevi almak için aynı anahtarla aynı isteği tekrar gönderin. Bir anahtarınız yoksa, tekrar denemeden önce bir görevin zaten oluşturulup oluşturulmadığını kontrol edin.

API Referansı

KonuReferans
Video OluşturmaVideo Oluşturma
Video Durumunu AlmaVideo Durumunu Alma
Görev Durumunu AlmaGörev Durumunu Alma
Görevi İptal EtmeGörevi İptal Etme
Faturalandırma ve FiyatlandırmaFaturalandırma ve Fiyatlandırma

Hailuo H3-Max; metinden, bir ilk kareden veya ilk ve son karelerden 480p ya da 768p çözünürlüğünde 5–15 saniyelik videolar oluşturur. Hız odaklı iş akışı, bir çekim fikrini hızlıca kısa bir klibe dönüştürmek için kullanışlıdır.

{
  "model": "hailuo-h3-max",
  "operation": "text-to-video",
  "prompt": "A slow camera move through a quiet garden",
  "resolution": "768p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Bu sayfada