switch_heading
Seedance 2.0 Mini API Dokümantasyonu
Seedance 2.0 Mini video üretim API'sini uygulamalarınıza entegre etmek için tam kılavuz.
Hızlı Başlangıç
| 1 | curl -X POST 'https://seedanceapi.org/v1/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "prompt": "A cinematic shot of mountains at sunrise with flowing clouds", |
| 6 | "aspect_ratio": "16:9", |
| 7 | "resolution": "720p", |
| 8 | "duration": "8" |
| 9 | }' |
Kimlik Doğrulama
Tüm API istekleri Authorization başlığında Bearer token kullanılarak kimlik doğrulaması gerektirir.
Önemli: API anahtarınızı panelinizdeki API Keys sayfasından alabilirsiniz. → API anahtarı al
| 1 | Authorization: Bearer YOUR_API_KEY |
Fiyatlandırma
480p Çözünürlük
Çıktı saniyesi başına 14,25 kredi, istek başına yukarı yuvarlanır
| Süre | Kredi |
|---|---|
| 4s | 57 credits |
| 5s | 72 credits |
| 8s | 114 credits |
| 10s | 143 credits |
| 12s | 171 credits |
| 15s | 214 credits |
720p Çözünürlük
Çıktı saniyesi başına 30,75 kredi, istek başına yukarı yuvarlanır
| Süre | Kredi |
|---|---|
| 4s | 123 credits |
| 5s | 154 credits |
| 8s | 246 credits |
| 10s | 308 credits |
| 12s | 369 credits |
| 15s | 462 credits |
API Uç Noktaları
/v1/generateSeedance 2.0 Mini modeli ile yeni video üretim görevi oluşturun. Metinden-video ve resimden-video modlarını destekler.
İstek Gövdesi
Üretilecek videonun metin açıklaması (maks. 2000 karakter)
Çıktı en-boy oranı. Desteklenen: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.
Video çözünürlüğü: 480p veya 720p Defaults to 720p.
Video süresi (saniye): 4–15 arası tam sayı Defaults to 8.
AI ses üretimini etkinleştir (fiyatı etkilemez) Defaults to false.
Kullanımdan kaldırıldı — uyumluluk için kabul edilir, Seedance 2.0 Mini yok sayar Defaults to false.
Resimden-video üretimi için referans resim URL'leri dizisi (maks. 1)
Asenkron durum bildirimleri için webhook URL'si. Herkese açık erişilebilir olmalıdır.
Metinden video
| 1 | { |
| 2 | "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves", |
| 3 | "aspect_ratio": "16:9", |
| 4 | "resolution": "720p", |
| 5 | "duration": "8" |
| 6 | } |
Resimden video
| 1 | { |
| 2 | "prompt": "The character slowly turns and smiles at the camera", |
| 3 | "image_urls": [ |
| 4 | "https://example.com/my-image.jpg" |
| 5 | ], |
| 6 | "aspect_ratio": "16:9", |
| 7 | "resolution": "720p", |
| 8 | "duration": "4" |
| 9 | } |
Ses üretimi ile
| 1 | { |
| 2 | "prompt": "A peaceful river flowing through a forest with birds singing", |
| 3 | "aspect_ratio": "16:9", |
| 4 | "resolution": "720p", |
| 5 | "duration": "8", |
| 6 | "generate_audio": true |
| 7 | } |
Yanıtlar
Task created successfully
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90abc123def456_seedance", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
/v1/statusVideo üretim görevinin durumunu kontrol edin ve tamamlandığında sonucu alın.
Sorgu Parametreleri
Generate uç noktasından dönen benzersiz görev ID'si
Örnek İstek
| 1 | curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
💡 Tip: Durum API'sindeki response alanı video URL'leri dizisidir. Video URL'sini almak için doğrudan data.response[0]'e erişebilirsiniz.
| 1 | // Extract video URL from response |
| 2 | const videoUrl = data.response[0]; |
Yanıtlar
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90abc123def456_seedance", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 246, |
| 8 | "created_at": "2026-02-07T10:30:00Z", |
| 9 | "request": { |
| 10 | "prompt": "A majestic eagle soaring through golden sunset clouds", |
| 11 | "aspect_ratio": "16:9", |
| 12 | "resolution": "720p", |
| 13 | "duration": "8" |
| 14 | }, |
| 15 | "response": [ |
| 16 | "https://cdn.example.com/videos/n90abc123def456_seedance.mp4" |
| 17 | ], |
| 18 | "error_message": null |
| 19 | } |
| 20 | } |
API Oyun Alanı
API'yi doğrudan tarayıcınızdan test edin. YOUR_API_KEY'i gerçek API anahtarınızla değiştirin.
Hata Kodları
| Status | Code | Description |
|---|---|---|
| 400 Geçersiz İstek | INVALID_PROMPT | Prompt geçersiz veya boş |
| 400 Geçersiz İstek | INVALID_ASPECT_RATIO | Desteklenmeyen en-boy oranı |
| 400 Geçersiz İstek | INVALID_RESOLUTION | Çözünürlük 480p veya 720p olmalıdır |
| 400 Geçersiz İstek | INVALID_DURATION | Süre 4, 8 veya 12 saniye olmalıdır |
| 400 Geçersiz İstek | TOO_MANY_IMAGES | image_urls dizisinde en fazla 1 resim URL'sine izin verilir |
| 401 Yetkisiz | INVALID_API_KEY | API anahtarı eksik veya geçersiz |
| 402 | INSUFFICIENT_CREDITS | Bu işlem için yeterli kredi yok |
| 404 Bulunamadı | TASK_NOT_FOUND | Görev ID'si bulunamadı veya hesabınıza ait değil |
| 500 Sunucu Hatası | INTERNAL_ERROR | Sunucu hatası, lütfen daha sonra tekrar deneyin |