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

İşlem	Gerekli veya tipik girdi	Kullanım durumu
`text-to-video`	`prompt`	Sadece metinden oluşturma
`image-to-video`	`image_url` veya uyumlu `image`	Başlangıç görüntüsünü canlandırma
`reference-to-video`	`reference_images` ve desteklenen modellerde isteğe bağlı `video_urls` / `audio_urls`	Kimliği, tarzı veya varlık referanslarını koruma
`start-end-to-video`	`start_image`, `end_image`	İlk ve son kareleri kontrol etme
`video-to-video`	`video_url` veya modele özgü `task_id`	Mevcut bir klibi dönüştürme veya büyütme
`motion-control`	`image_url` artı `video_url`	Bir konuya hareket referansı uygulama
`audio-to-video`	`audio_url`	Ses koşullu video akışları
`video-extension`	`task_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	İşlemler	Girdiler	Çözünürlük	Süre	Ses seçici
`pixverse-c1`, `pixverse-v6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	`prompt`; `image_url`; `start_image` + `end_image`; `reference_images`	360p, 540p, 720p, 1080p	1 ile 15 saniye arasında herhangi bir tam sayı	`output_audio`, varsayılan `false`
`pixverse-v5.6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	C1 ve V6 ile aynı alanlar	360p, 540p, 720p, 1080p	5, 8 veya 10 saniye; 1080p, 5 veya 8 saniyeyi destekler	`output_audio`, varsayılan `false`
`happyhorse-1.0`	`text-to-video`, `image-to-video`, `reference-to-video`, `video-to-video`	`prompt`; `image_url`; `reference_images`; `video_url` + `reference_images`	720p, 1080p	Oluşturma işlemleri için 3 ila 15 saniye; video-to-video çıktısı 15 saniye ile sınırlıdır	`output_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ı

Konu	Referans
Video Oluştur	Video Oluştur
Video Durumunu Al	Video Durumunu Al
Görev Durumunu Al	Görev Durumunu Al
Görevi İptal Et	Görevi İptal Et
Faturalama ve Fiyatlandırma	Faturalama 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.

Başlarken

Temel kılavuzlar

Medya kılavuzları

Kamu Sözleşmesi

Model Keşfi

İstek Oluşturma

Girdiler ve Modele Özgü Alanlar

PixVerse ve HappyHorse

Anket Sonuçları

Yaygın Hatalar

API Referansı

OpenAI tarzı ve Volc uyumlu video API’leri

​Kamu Sözleşmesi

​Model Keşfi

​İstek Oluşturma

​Girdiler ve Modele Özgü Alanlar

​PixVerse ve HappyHorse

​Anket Sonuçları

​Yaygın Hatalar

​API Referansı

​OpenAI tarzı ve Volc uyumlu video API’leri

Kamu Sözleşmesi

Model Keşfi

İstek Oluşturma

Girdiler ve Modele Özgü Alanlar

PixVerse ve HappyHorse

Anket Sonuçları

Yaygın Hatalar

API Referansı

OpenAI tarzı ve Volc uyumlu video API’leri