Seedance 2.0 API Dokümantasyonu

Seedance 2.0 video üretim API'sini uygulamalarınıza entegre etmek için tam kılavuz.

API v1.0 Base URL: https://seedanceapi.org/v1

Hızlı Başlangıç

bash

curl -X POST 'https://seedanceapi.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8"
  }'

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

Authorization: Bearer YOUR_API_KEY

Fiyatlandırma

480p

480p Çözünürlük

Hızlı üretim, önizleme ve taslaklar için uygun

Süre	Ses olmadan	Ses ile
4s	8 credits ($0.04)	14 credits ($0.07)
8s	14 credits ($0.07)	28 credits ($0.14)
12s	19 credits ($0.095)	38 credits ($0.19)

720p

720p Çözünürlük

Yüksek kalite çıktı, üretim için önerilir

Süre	Ses olmadan	Ses ile
4s	14 credits ($0.07)	28 credits ($0.14)
8s	28 credits ($0.14)	56 credits ($0.28)
12s	42 credits ($0.21)	84 credits ($0.42)

API Uç Noktaları

POST/v1/generateYeni video oluştur

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

İstek Gövdesi

Parameter	Tür	Gerekli	Açıklama
`prompt`	string	Gerekli	Üretilecek videonun metin açıklaması (maks. 2000 karakter)
`aspect_ratio`	string	İsteğe Bağlı	Çıkış en-boy oranı. Desteklenen: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (Varsayılan: 1:1)
`resolution`	string	İsteğe Bağlı	Video çözünürlüğü: "480p" veya "720p" (Varsayılan: 720p)
`duration`	string	İsteğe Bağlı	Video süresi saniye olarak: "4", "8" veya "12" (Varsayılan: 8)
`generate_audio`	boolean	İsteğe Bağlı	Video için AI ses üretimini etkinleştir (Varsayılan: false)
`fixed_lens`	boolean	İsteğe Bağlı	Hareket bulanıklığını azaltmak için kamerayı sabitle (Varsayılan: false)
`image_urls`	string[]	İsteğe Bağlı	Resimden-video üretimi için referans resim URL'leri dizisi (maks. 1)
`callback_url`	string	İsteğe Bağlı	Asenkron durum bildirimleri için webhook URL'si. Herkese açık erişilebilir olmalıdır.

Metinden video

json

{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

Resimden video

json

{
  "prompt": "The character slowly turns and smiles at the camera",
  "image_urls": [
    "https://example.com/my-image.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "4"
}

Ses üretimi ile

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

Yanıtlar

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

GET/v1/statusGörev durumunu al

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

Sorgu Parametreleri

Parameter	Tür	Gerekli	Açıklama
`task_id`	string	Gerekli	Generate uç noktasından dönen benzersiz görev ID'si

Örnek İstek

bash

curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -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

// Extract video URL from response
const videoUrl = data.response[0];

Yanıtlar

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

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

Temel URL

Uç Nokta

Başlıklar

İstek Gövdesi

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