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 girdi | Kullanım durumu |
|---|---|---|
text-to-video | prompt | Sadece metinden oluşturma |
image-to-video | image_url veya uyumlu image | Başlangıç görselini canlandırma |
reference-to-video | reference_images ve desteklenen modellerde isteğe bağlı video_urls / audio_urls | Kimlik, stil 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 özel task_id | Mevcut bir klibi dönüştürme veya ölçeklendirme |
motion-control | image_url ve video_url | Bir özneye hareket referansı uygulama |
audio-to-video | audio_url | Ses ile koşullandırılmış video akışları |
video-extension | task_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-fastveveo3.1-liteher zaman ses üretir.output_audioparametresini atlayın veyatruegönderin;falsedeğeri reddedilir.wan-2.6vewan-2.7her zaman ses içerir.output_audioparametresini atlayın veyatruegönderin.wan-3.0vewan-3.0-primeda her zaman ses içerir ve herhangi bir ses seçici kabul etmez.hailuo-h3yerel ses üretir ve sessize alma anahtarı yoktur. Model detaylarında listelenmeyen bir ses seçici göndermeyin.viduq3-proveviduq3-turbovarsayılan olarak ses üretir; sessiz çıktı içinoutput_audio: false(veyaaudio: false) gönderin. Seedance ve PixVerse modellerioutput_audiokabul 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_urlsgirdi 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-videovideo-to-video işlemi içinpromptve herkese açık HTTPS.mp4formatında birvideo_urlgönderin. Önceki bir görevden elde edilen TokenLab.mp4sonuç URL'si de çalışır. Bu işlemduration,resolutionveyaaspect_ratioseçicilerini kullanmaz.
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
}'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.
durationdeğerinin girdi referans videosunun uzunluğunu belirttiğini varsaymayın; bu genellikle oluşturulan çıktının uzunluğunu kontrol eder.POST /v1/videos/generationsisteğiyle birlikte birIdempotency-Keygö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ı
| Konu | Referans |
|---|---|
| Video Oluşturma | Video Oluşturma |
| Video Durumunu Alma | Video Durumunu Alma |
| Görev Durumunu Alma | Görev Durumunu Alma |
| Görevi İptal Etme | Görevi İptal Etme |
| Faturalandırma ve Fiyatlandırma | Faturalandı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"
}