label llms.txt open_chatgpt

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.

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

Hızlı Başlangıç

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

http
1Authorization: Bearer YOUR_API_KEY

Fiyatlandırma

480p

480p Çözünürlük

Çıktı saniyesi başına 14,25 kredi, istek başına yukarı yuvarlanır

SüreKredi
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

720p Çözünürlük

Çıktı saniyesi başına 30,75 kredi, istek başına yukarı yuvarlanır

SüreKredi
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

API Uç Noktaları

POST/v1/generate

Seedance 2.0 Mini modeli ile yeni video üretim görevi oluşturun. Metinden-video ve resimden-video modlarını destekler.

İstek Gövdesi

Body ParametersJSON
prompt:string

Üretilecek videonun metin açıklaması (maks. 2000 karakter)

aspect_ratio:optional string

Çıktı en-boy oranı. Desteklenen: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.

resolution:optional string

Video çözünürlüğü: 480p veya 720p Defaults to 720p.

duration:optional string

Video süresi (saniye): 4–15 arası tam sayı Defaults to 8.

generate_audio:optional boolean

AI ses üretimini etkinleştir (fiyatı etkilemez) Defaults to false.

fixed_lens:optional boolean

Kullanımdan kaldırıldı — uyumluluk için kabul edilir, Seedance 2.0 Mini yok sayar Defaults to false.

image_urls:optional string[]

Resimden-video üretimi için referans resim URL'leri dizisi (maks. 1)

callback_url:optional string

Asenkron durum bildirimleri için webhook URL'si. Herkese açık erişilebilir olmalıdır.

Metinden video

json
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

json
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

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

Video üretim görevinin durumunu kontrol edin ve tamamlandığında sonucu alın.

Sorgu Parametreleri

Body ParametersJSON
task_id:string

Generate uç noktasından dönen benzersiz görev ID'si

Örnek İstek

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

javascript
1// Extract video URL from response
2const 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.

API AlanıPOST

Hata Kodları

StatusCodeDescription
400 Geçersiz İstekINVALID_PROMPTPrompt geçersiz veya boş
400 Geçersiz İstekINVALID_ASPECT_RATIODesteklenmeyen en-boy oranı
400 Geçersiz İstekINVALID_RESOLUTIONÇözünürlük 480p veya 720p olmalıdır
400 Geçersiz İstekINVALID_DURATIONSüre 4, 8 veya 12 saniye olmalıdır
400 Geçersiz İstekTOO_MANY_IMAGESimage_urls dizisinde en fazla 1 resim URL'sine izin verilir
401 YetkisizINVALID_API_KEYAPI anahtarı eksik veya geçersiz
402 INSUFFICIENT_CREDITSBu işlem için yeterli kredi yok
404 BulunamadıTASK_NOT_FOUNDGörev ID'si bulunamadı veya hesabınıza ait değil
500 Sunucu HatasıINTERNAL_ERRORSunucu hatası, lütfen daha sonra tekrar deneyin