API Dokümantasyonu

Seedance API Referansı

Seedance Video AI'yı uygulamalarınıza entegre etmek için eksiksiz API dokümantasyonu. Metin istemlerinden ve görsellerden yüksek kaliteli videolar oluşturun.

REST API

JSON Yanıtları

Video Oluşturma

Kimlik Doğrulama

Seedance API, Bearer Token kimlik doğrulaması kullanır. API tokenınızı Authorization başlığına ekleyin:

Authorization: Bearer your-api-token-here

Güvenlik Notu: API tokenınızı asla istemci tarafı kodunda veya herkese açık depolarda ifşa etmeyin.

Temel URL

Tüm API istekleri şu adrese yapılmalıdır:

https://seedanceapi.org/v1

API Uç Noktaları

POST

Video Oluştur

/generate

AI modelleri kullanarak metin istemlerinden ve görsellerden yüksek kaliteli videolar oluşturun.

İstek Gövdesi

Metinden Videoya (T2V)

{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}

Görselden Videoya (I2V)

{
  "prompt": "kissing",
  "mode": "img2img",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1,
  "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}

Parametreler

endpoints.generate.params.header.parameter	endpoints.generate.params.header.type	endpoints.generate.params.header.description
prompt	endpoints.generate.params.types.string	Oluşturulacak videonun metin açıklaması
mode	endpoints.generate.params.types.string	Oluşturma modu: T2V için "text" veya I2V için "img2img"
image_url	endpoints.generate.params.types.string?	Giriş görsel URL'si (img2img modu için gerekli)
resolution	endpoints.generate.params.types.string	Video çözünürlüğü: "480p", "720p" veya "1080p"
ratio	endpoints.generate.params.types.string	Video en boy oranı (varsayılan: "adaptive")
duration	endpoints.generate.params.types.integer	Video süresi saniye cinsinden (varsayılan: 5)
framespersecond	endpoints.generate.params.types.integer	Saniyedeki kare sayısı (varsayılan: 24)
seed	endpoints.generate.params.types.integer	Tekrarlanabilir sonuçlar için rastgele tohum (varsayılan: -1)

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

endpoints.generate.curl

Metinden Videoya (T2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cardi b bends over to pick up coins",
    "mode": "text",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1
  }'

Görselden Videoya (I2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kissing",
    "mode": "img2img",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1,
    "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
  }'

GET

Görev Durumunu Al

/status?task_id=xxxx

Devam eden veya tamamlanmış bir video oluşturma görevinin durumunu kontrol edin.

Parametreler

endpoints.generate.params.header.parameter	endpoints.generate.params.header.type	endpoints.generate.params.header.description
task_id	endpoints.generate.params.types.string	Oluşturma uç noktasından döndürülen görev kimliği

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 10,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "user_request": {
      "prompt": "A beautiful landscape with flowing water",
      "model": "seedance-video-v1",
      "duration": 5
    },
    "user_response": {
      "video_url": "https://cdn.seedance.com/generated/video.mp4",
      "last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
    },
    "provider_status": "success",
    "model": "seedance-video-v1"
  }
}

endpoints.generate.curl

curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Hata İşleme

Seedance API standart HTTP durum kodları ve hata mesajları döndürür:

HTTP Durum Kodları

200OK

400Bad Request

401Unauthorized

429Rate Limited

500Server Error

Hata Yanıt Formatı

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

En İyi Uygulama: Hataları her zaman zarif bir şekilde ele alın ve yanıt gövdesini işlemeden önce HTTP durum kodlarını kontrol edin.

Hız Sınırları

100

istek/dakika

Ücretsiz Plan

1000

istek/dakika

Pro Plan

5000

istek/dakika

Kurumsal

Hız Sınırı Başlıkları: Her yanıt, mevcut kullanımınızı izlemek için X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını içerir.

Geliştirmeye başlamaya hazır mısınız?

API anahtarınızı alın ve Seedance ile harika videolar oluşturmaya başlayın

Başla Ana Sayfaya Dön