switch_heading
Seedance 2.5 API Belgeleri
API v3 ile Seedance 2.5 ve Seedance 2.5 Flash videoları oluşturun: metinden videoya, referans görsel, video ve ses, ilk/son kare, video düzenleme ve 4K çıkış.
API v3 yalnızca Seedance 2.5 için ayrı bir uç noktadır. Mevcut /v1 ve /v2 entegrasyonları aynen çalışmaya devam eder; /v3'e yalnızca Seedance 2.5 istediğinizde geçin.
Hızlı Başlangıç
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
Kimlik Doğrulama
Tüm API istekleri, Authorization başlığında Bearer token gerektirir.
Önemli: API anahtarınızı kontrol panelinizdeki API Keys sayfasından alın. Sunucunuzda saklayın ve asla tarayıcı koduna eklemeyin. → API Anahtarınızı Alın
| 1 | Authorization: Bearer YOUR_API_KEY |
Oluşturma modları
| Mod | Gönderilecek alanlar |
|---|---|
| Metinden videoya | prompt + aspect_ratio |
| Referanslı oluşturma (görsel, video, ses) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| İlk / son kare | prompt + first_frame_url (+ last_frame_url) |
| Video düzenleme | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
Fiyatlandırma (kredi)
Krediler video saniyesi başına ücretlendirilir; modele, çözünürlüğe ve referans video gönderip göndermediğinize bağlıdır. Tutar görev oluşturulduğunda düşülür ve başarısız olursa otomatik iade edilir.
Kredi yüklemeniz mi gerekiyor? → Fiyatlandırma sayfasından yükle. 1 USD = 100 kredi.
Seedance 2.5
En yüksek kalite; 480p, 720p ve yerel 4K destekler.
| Çözünürlük | Giriş | Ücret | Örnek |
|---|---|---|---|
| 480p | Metin / görsel / ses | 28 kredi / sn | 10 sn çıkış = 280 kredi |
| 480p | Referans videolu | 17 kredi / sn | 5 sn referans + 10 sn çıkış = 255 kredi |
| 720p | Metin / görsel / ses | 63 kredi / sn | 10 sn çıkış = 630 kredi |
| 720p | Referans videolu | 38 kredi / sn | 5 sn referans + 10 sn çıkış = 570 kredi |
| 4k | Metin / görsel / ses | 251 kredi / sn | 10 sn çıkış = 2510 kredi |
| 4k | Referans videolu | 155 kredi / sn | 5 sn referans + 10 sn çıkış = 2325 kredi |
Seedance 2.5 Flash
Daha hızlı ve daha ucuz; 480p ve 720p destekler.
| Çözünürlük | Giriş | Ücret | Örnek |
|---|---|---|---|
| 480p | Metin / görsel / ses | 18.5 kredi / sn | 10 sn çıkış = 185 kredi |
| 480p | Referans videolu | 11.5 kredi / sn | 5 sn referans + 10 sn çıkış = 173 kredi |
| 720p | Metin / görsel / ses | 41 kredi / sn | 10 sn çıkış = 410 kredi |
| 720p | Referans videolu | 25.5 kredi / sn | 5 sn referans + 10 sn çıkış = 383 kredi |
reference_video_urls ile faturalandırma, referans video saniyelerinde daha düşük video giriş ücretini, çıkış saniyeleriyle birlikte uygular. Video düzenleme (duration -1), giriş videosunun uzunluğunun iki katı üzerinden ücretlendirilir. Toplamlar tam krediye yukarı yuvarlanır.
API Uç Noktaları
/v3/generateBir Seedance 2.5 veya Seedance 2.5 Flash işi başlatın. Çağrı hemen bir task_id döndürür; sonucu almak için /v3/status'u sorgulayın veya callback_url gönderin.
İstek Gövdesi
Metin istemi (zorunlu, en fazla 5000 karakter).
seedance-2.5 (varsayılan) veya seedance-2.5-flash. Defaults to seedance-2.5.
Saniye cinsinden çıkış uzunluğu: 4 ile 30 arasında herhangi bir tam sayı. Video düzenleme için -1 kullanın; çıkış, giriş videosunun uzunluğunu korur. Defaults to 5.
Seedance 2.5: 480p, 720p veya 4k. Seedance 2.5 Flash: 480p veya 720p. 1080p mevcut değildir. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 veya adaptive. Video düzenleme adaptive gerektirir. Defaults to 16:9.
En fazla 4 referans görsel URL'si (http/https). Her görselin nasıl kullanılacağını istemde açıklayın.
İlk kare olarak kullanılan görsel URL'si. image_urls, reference_video_urls veya reference_audio_urls ile birleştirilemez.
Son kare olarak kullanılan isteğe bağlı görsel URL'si. first_frame_url gerektirir.
En fazla 3 referans video URL'si, toplam 30 saniye. Video düzenleme için tam olarak 4 ile 30 saniye arasında bir video gönderin.
En fazla 3 referans ses URL'si; örneğin müzik veya seslendirme parçası.
Video ile birlikte bir film müziği oluşturur. Defaults to true.
Modelin istemdeki konuları web'de aramasına izin verir. Defaults to false.
Görev bittiğinde çağrılan isteğe bağlı webhook (herkese açık URL; localhost'a izin verilmez).
İsteğe bağlı: sonucun herkese açık galeride görünmesine izin verir.
Metinden videoya
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
Referans görsel + ses
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
İlk ve son kare (Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
Video düzenleme
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
4K çıkış
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
Yanıtlar
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusstatus SUCCESS veya FAILED olana kadar task_id ile sorgulayın. Burada yalnızca /v3/generate ile oluşturulan görevler döndürülür.
Sorgu Parametreleri
POST /v3/generate tarafından döndürülen görev kimliği (sd25 ile biter).
Örnek İstek
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: status SUCCESS olduğunda data.response bir video URL dizisidir; ilk URL için data.response[0] kullanın. Saklamanız gerekiyorsa dosyayı indirip kaydedin.
| 1 | const videoUrl = data.response[0]; |
Yanıtlar
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
API Deneme Alanı
API'yi tarayıcıda deneyin. YOUR_API_KEY yerine gerçek anahtarınızı yazın. Her başarılı çağrı ücretlendirilir.
Hata Kodları
| Status | Ne zaman oluşur |
|---|---|
| 400 Geçersiz İstek | Bir parametre eksik veya geçersiz; örneğin desteklenmeyen bir model, resolution, aspect_ratio, duration veya medya URL'si. Mesaj hangisi olduğunu açıklar. |
| 401 Yetkisiz | API anahtarı eksik veya geçersiz. |
| 402 | Bu görev için yeterli kredi yok. |
| 404 Bulunamadı | Görev mevcut değil veya /v3/generate ile oluşturulmamış. |
| 500 Sunucu Hatası | Sunucu hatası. Daha sonra tekrar deneyin; başarısız görevler otomatik olarak iade edilir. |