Video Üretimi

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 modelin desteklediği görsel alanlarında herkese açık HTTP(S) URL’leri veya desteklenen data URL’lerini gönderin. Bunlar normal medya girdisi olarak işlenir ve otomatik olarak yeniden kullanılabilir materyal kimliği oluşturmaz.

Açıkça belirtilen materyal hâlâ hazırlanıyorsa POST /v1/videos/generations, inactive_asset_ids ile 409 seedance_material_preparing döndürür. Varlıkları ACTIVE olana kadar sorgulayıp aynı kimliklerle yeniden deneyin. FAILED durumunda önce error_message değerine göre düzeltin veya yeniden içe aktarın.

Kamu SözleşmesiCopy Anchor Link

Ü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.

Model KeşfiCopy Anchor Link

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, 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şturmaCopy Anchor Link

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ü AlanlarCopy Anchor Link

Ses davranışı seçilen modele ve işleme bağlıdır. Ses anahtarı sunulmasa da video ses içerebilir. Parametreyi atlamak, false göndermekle aynı değildir.

• veo3.1 ve veo3.1-fast, Gemini API sözleşmesine göre her zaman ses üretir. wan-2.6 ve wan-2.7 video üretiminde de ses kapatılamaz. output_audio alanını atlayın veya model ayrıntıları izin veriyorsa true kullanın.
• hailuo-h3 ve Grok video modelleri yerel ses üretir. Model ayrıntılarında bulunmayan ses anahtarlarını eklemeyin.
• Seedance 1.5/2.x ve viduq3-pro / viduq3-turbo için ses varsayılan olarak açıktır; sessiz çıktı da desteklenir. PixVerse C1/V5.6/V6 için varsayılan kapalıdır. output_audio yalnızca bu alanı listeleyen işlemlerde kullanılmalıdır; Vidu, sözleşmesinde tanımlı boolean audio alanını da kabul eder.
• audio_url / audio_urls giriş veya referans sesi sağlar; çıktı sesini açıp kapatmaz. Video düzenleme, hareket ve stil aktarımı kaynak sesini koruyabilir. Orijinal sesi korumak, sessize almak değildir.

İzin verilen değerler ve ses fiyatları için model ayrıntılarına bakın. Desteklenen outputAudio, generate_audio ve boolean audio takma adları birlikte gönderildiğinde output_audio ile aynı olmalıdır. Kontroller sürüm ve işleme göre değişebilir.

• 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 video-to-video için prompt ve herkese açık bir HTTPS .mp4 adresini video_url olarak gönderin. Bu işlem duration, resolution veya aspect_ratio seçeneklerini kullanmaz.

PixVerse ve HappyHorseCopy Anchor Link

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ıCopy Anchor Link

Ö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 HatalarCopy Anchor Link

• 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ıCopy Anchor Link

OpenAI tarzı ve Volc uyumlu video API’leriCopy Anchor Link

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.

{
  "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"
}