Ana içeriğe atla
Video üretimi asenkron bir süreçtir. POST /v1/videos/generations bir kamu görev kimliği ve genellikle bir poll_url döner; nihai video daha sonraki durum yanıtlarında görünür. Seçilen Seedance modeli TokenLab materyal kitaplığını kullanabiliyorsa, görsel URL’leri ve desteklenen inline data URL’leri oluşturma öncesinde yeniden kullanılabilir TokenLab materyalleri olarak hazırlanır. Hazırlık 60 saniyeyi aşarsa, dönen auto_material_asset_ids değerleri ACTIVE olduktan sonra tekrar deneyin. Seçilen model materyal kitaplığını kullanamıyorsa normal görsel girdileri standart görsel yolunda devam eder.

​
Kamu Sözleşmesi

Üretimde açık operation kullanın. TokenLab bazı işlemleri girdilerden çıkarabilir, ancak açık işlem değerleri doğrulama, destek ve yeniden denemeleri daha net hale getirir.
İşlemGerekli veya tipik girdiKullanım durumu
text-to-videopromptSadece metinden oluşturma
image-to-videoimage_url veya uyumlu imageBaşlangıç görüntüsünü canlandırma
reference-to-videoreference_images ve desteklenen modellerde isteğe bağlı video_urls / audio_urlsKimliği, tarzı 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 özgü task_idMevcut bir klibi dönüştürme veya büyütme
motion-controlimage_url artı video_urlBir konuya hareket referansı uygulama
audio-to-videoaudio_urlSes koşullu video akışları
video-extensiontask_id, extend_at veya modele özgü genişletme alanlarıOluşturulan bir videoyu devam ettirme

​
Model Keşfi

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"
model alanında TokenLab’da görünen model IDlerini kullanın; özellik varyantlarını operation ve ilgili medya girdileriyle seçin. Örnekler: wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, kling-3.0-video, veo3.1, seedance-2.0; operasyona özel ekleri TokenLab model adı olarak kullanmayın. reference_images, kling_elements, output_audio, duration, resolution veya aspect_ratio gibi özel alanlara güvenmeden önce seçilen model detayını okuyun.

​
İstek Oluşturma

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": "Güneş ışığıyla aydınlatılmış bir bahçede yürüyen bir kedinin sakin sinematik görüntüsü",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
Üretim medya girişi için satır içi data: URL’leri yerine herkese açık https URL’lerini tercih edin. Geçici URL kullanıyorsanız, TokenLab görevi oluşturmayı bitirene kadar geçerli tutun.

​
Girdiler ve Modele Özgü Alanlar

  • Veo 3 ailesi istekleri output_audio atlandığında varsayılan olarak sesli açılır. Model bu geçişi destekliyorsa ve kullanıcı deneyiminiz sese bağlıysa, bunu açıkça ayarlayın.
  • kling_elements, kling-3.0-video görüntü koşullu istekler içindir. Her bir öğeyi prompt içinde @name olarak referans gösterin; bunu output_audio=true ile birleştirmeyin.
  • Seedance 2.0 ailesinde 4K çıktı, Fast/Mini çözünürlük sınırları veya çok modlu referans girdileri kullanmadan önce Seedance 2.0 video modelleri kılavuzunu okuyun.
  • grok-imagine-video için, video-to-video bir kamuya açık .mp4 video_url kullanır; modele özgü sınırlamalar, örneğin duration ve resolution, model sözleşmesinden gelmelidir.

​
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
  }'

​
Anket Sonuçları

Öncelikle döndürülen poll_url’yi kullanın. Sabit bir uç noktaya ihtiyacınız varsa, oluşturma yanıtındaki aynı id / task_id ile GET /v1/tasks/{id} kullanın. Tamamlanan video görevleri, modele ve çıktı sayısına bağlı olarak video_url, video veya videos dönebilir. billing_transaction_id değerini görev tanımlayıcısı değil, faturalama tanımlayıcısı olarak değerlendirin.

​
Yaygın Hatalar

  • Eski video durum yollarını sabit kodlamayın; poll_url’yi tercih edin.
  • Model sözleşmesi izin vermedikçe, ilk kare alanlarını özel referans-görüntü akışları ile birleştirmeyin.
  • duration’ın girdi referans video uzunluğunu tanımladığını varsaymayın; genellikle üretilen çıktı uzunluğunu kontrol eder.
  • Bir zaman aşımından sonra oluşturma isteklerini yeniden denemeden önce bir görevin zaten oluşturulup oluşturulmadığını kontrol etmeyin.

​
API Referansı

KonuReferans
Video OluşturVideo Oluştur
Video Durumunu AlVideo Durumunu Al
Görev Durumunu AlGörev Durumunu Al
Görevi İptal EtGörevi İptal Et
Faturalama ve FiyatlandırmaFaturalama ve Fiyatlandırma

​
OpenAI tarzı ve Volc uyumlu video API’leri

Modeller arasında TokenLab birleşik video API’si için /v1/videos/generations kullanın. Zaten Volc tarzı content[] veya Action istekleri kullanan mevcut bir Seedance 2.0 entegrasyonunu taşıyorsanız /api/v3 altındaki Seedance uyumluluk endpoint’lerini kullanabilirsiniz. İki stil de TokenLab Bearer API key ve asenkron polling kullanır, ancak istek ve yanıt şekilleri farklıdır.