Seedance 2.0
Seedance 2.0
DokumantasyonBaslangic
API Genel BakisMetinden videoyaGoruntuden videoya
API Referansi

API Genel Bakis

Seedance 2.0 Open API de kimlik dogrulama, is gonderimi, durum sorgulama ve webhook kullanimini anlayin.

Seedance 2.0 Open API ile kendi urununuzden asenkron video uretim gorevleri gonderebilir ve islem tamamlandiginda sonucu alabilirsiniz.

Base URL

https://www.seedance2.ink

Authentication

Tum Open API istekleri, Seedance panelinde olusturulan bir Bearer token kullanir.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Entegrasyon akisi

  1. Seedance panelinde bir API Key olusturun.
  2. POST /api/open/v1/video/generations ile bir gorev gonderin.
  3. Donen requestId degerini saklayin.
  4. GET /api/open/v1/video/generations/{requestId} ile son duruma kadar sorgulayin.
  5. Isterseniz tamamlanma bildirimleri icin webhook kullanin.

Temel endpoint ler

MethodEndpointDescription
GET/api/open/v1/modelsKullanilabilir modelleri, sureleri, oranlari, cozunurlukleri ve fiyat bilgilerini listeler.
POST/api/open/v1/video/generationsYeni bir video uretim gorevi olusturur.
GET/api/open/v1/video/generations/{requestId}Gorev durumunu sorgular ve tamamlandiginda cikti URL sini doner.
POST/api/open/v1/video/generations/{requestId}/cancelKuyruktaki veya islenen bir gorevi iptal eder.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

Durumlar

StatusDescription
queuedIstek kabul edildi ve kuyrukta bekliyor.
processingUretim su anda isleniyor.
succeededGorev basariyla tamamlandi ve output.url hazir.
failedGorev basarisiz oldu. error alanini kontrol edin.
cancelledGorev tamamlanmadan once iptal edildi.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook lar

Her istek icin webhookUrl tanimlayabilir veya API Key seviyesinde varsayilan bir callback adresi ayarlayabilirsiniz.

  • Ikisi de varsa, istek icindeki webhookUrl onceliklidir.
  • Webhook Secret tanimliysa x-seedance-signature basligi gonderilir.
  • Webhook lar sadece gorev son duruma ulastiginda gonderilir.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Hata kodlari

HTTP statusError codeDescription
400invalid_requestIstek govdesi beklenen semaya uymuyor.
401unauthorizedAPI Key eksik veya gecersiz.
402insufficient_creditsGorev olusturmak icin yeterli kredi yok.
404not_foundMevcut API Key icin gorev bulunamadi.
429rate_limitedDakikalik limit veya aylik kota asildi.
500internal_errorBeklenmeyen bir sunucu hatasi olustu.

Sonraki adimlar

  • Metinden videoya sayfasini okuyun
  • Goruntuden videoya sayfasini okuyun

Baslangic

Seedance 2.0 ile en hizli sekilde uretken olmaya baslayin.

Metinden videoya

Seedance 2.0 Open API ile metin istemlerinden video uretin.

İçindekiler

Base URLAuthenticationEntegrasyon akisiTemel endpoint lerAvailable ModelsDurumlarModels Endpoint ExampleWebhook larHata kodlariSonraki adimlar