label llms.txt open_chatgpt

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 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

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ıç

bash
1curl -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

http
1Authorization: Bearer YOUR_API_KEY

Oluşturma modları

ModGönderilecek alanlar
Metinden videoyaprompt + aspect_ratio
Referanslı oluşturma (görsel, video, ses)prompt + image_urls / reference_video_urls / reference_audio_urls
İlk / son kareprompt + first_frame_url (+ last_frame_url)
Video düzenlemeprompt + 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.

2.5

Seedance 2.5

En yüksek kalite; 480p, 720p ve yerel 4K destekler.

ÇözünürlükGirişÜcretÖrnek
480pMetin / görsel / ses28 kredi / sn10 sn çıkış = 280 kredi
480pReferans videolu17 kredi / sn5 sn referans + 10 sn çıkış = 255 kredi
720pMetin / görsel / ses63 kredi / sn10 sn çıkış = 630 kredi
720pReferans videolu38 kredi / sn5 sn referans + 10 sn çıkış = 570 kredi
4kMetin / görsel / ses251 kredi / sn10 sn çıkış = 2510 kredi
4kReferans videolu155 kredi / sn5 sn referans + 10 sn çıkış = 2325 kredi
Flash

Seedance 2.5 Flash

Daha hızlı ve daha ucuz; 480p ve 720p destekler.

ÇözünürlükGirişÜcretÖrnek
480pMetin / görsel / ses18.5 kredi / sn10 sn çıkış = 185 kredi
480pReferans videolu11.5 kredi / sn5 sn referans + 10 sn çıkış = 173 kredi
720pMetin / görsel / ses41 kredi / sn10 sn çıkış = 410 kredi
720pReferans videolu25.5 kredi / sn5 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ı

POST/v3/generate

Bir 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

Body ParametersJSON
prompt:string

Metin istemi (zorunlu, en fazla 5000 karakter).

model:optional string

seedance-2.5 (varsayılan) veya seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

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.

resolution:optional string

Seedance 2.5: 480p, 720p veya 4k. Seedance 2.5 Flash: 480p veya 720p. 1080p mevcut değildir. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 veya adaptive. Video düzenleme adaptive gerektirir. Defaults to 16:9.

image_urls:optional string[]

En fazla 4 referans görsel URL'si (http/https). Her görselin nasıl kullanılacağını istemde açıklayın.

first_frame_url:optional string

İlk kare olarak kullanılan görsel URL'si. image_urls, reference_video_urls veya reference_audio_urls ile birleştirilemez.

last_frame_url:optional string

Son kare olarak kullanılan isteğe bağlı görsel URL'si. first_frame_url gerektirir.

reference_video_urls:optional string[]

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.

reference_audio_urls:optional string[]

En fazla 3 referans ses URL'si; örneğin müzik veya seslendirme parçası.

generate_audio:optional boolean

Video ile birlikte bir film müziği oluşturur. Defaults to true.

web_search:optional boolean

Modelin istemdeki konuları web'de aramasına izin verir. Defaults to false.

callback_url:optional string

Görev bittiğinde çağrılan isteğe bağlı webhook (herkese açık URL; localhost'a izin verilmez).

public:optional boolean

İsteğe bağlı: sonucun herkese açık galeride görünmesine izin verir.

Metinden videoya

json
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

json
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)

json
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

json
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ış

json
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}
GET/v3/status

status 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

Body ParametersJSON
task_id:string

POST /v3/generate tarafından döndürülen görev kimliği (sd25 ile biter).

Örnek İstek

bash
1curl -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.

javascript
1const 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.

API AlanıPOST

Hata Kodları

StatusNe zaman oluşur
400 Geçersiz İstekBir 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 YetkisizAPI 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.