Seedance 2.0
Seedance 2.0
DokumentacjaPierwsze kroki
Przeglad APITekst na wideoObraz na wideo
Referencja API

Przeglad API

Poznaj uwierzytelnianie, wysylanie zadan, sprawdzanie statusu i webhooki w Seedance 2.0 Open API.

Seedance 2.0 Open API pozwala wysylac asynchroniczne zadania generowania wideo z Twojego produktu i pobierac wynik po zakonczeniu przetwarzania.

Base URL

https://www.seedance2.ink

Authentication

Wszystkie zadania Open API uzywaja tokenu Bearer utworzonego w panelu Seedance.

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

Przeplyw integracji

  1. Utworz API Key w panelu Seedance.
  2. Wyslij zadanie przez POST /api/open/v1/video/generations.
  3. Zapisz zwrocone requestId.
  4. Odpytuj GET /api/open/v1/video/generations/{requestId} az do statusu koncowego.
  5. Opcjonalnie skonfiguruj webhook, aby dostawac powiadomienia o zakonczeniu.

Glowne endpointy

MethodEndpointDescription
GET/api/open/v1/modelsZwraca dostepne modele, czasy trwania, proporcje, rozdzielczosci i dane cenowe.
POST/api/open/v1/video/generationsTworzy nowe zadanie generowania wideo.
GET/api/open/v1/video/generations/{requestId}Sprawdza status zadania i zwraca URL wyniku po zakonczeniu.
POST/api/open/v1/video/generations/{requestId}/cancelAnuluje zadanie w kolejce lub w trakcie przetwarzania.

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

Statusy

StatusDescription
queuedZadanie zostalo przyjete i czeka w kolejce.
processingGenerowanie jest obecnie przetwarzane.
succeededZadanie zakonczylo sie sukcesem i output.url jest dostepny.
failedZadanie zakonczylo sie bledem. Sprawdz error.
cancelledZadanie zostalo anulowane przed zakonczeniem.

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
      }
    }
  ]
}

Webhooki

Mozesz ustawic webhookUrl dla pojedynczego zapytania albo skonfigurowac domyslny URL callback na poziomie API Key.

  • Jesli ustawiono oba, priorytet ma webhookUrl z requestu.
  • Jesli skonfigurowano Webhook Secret, wysylany jest naglowek x-seedance-signature.
  • Webhooki sa wysylane tylko wtedy, gdy zadanie osiagnie status koncowy.
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
}

Kody bledow

HTTP statusError codeDescription
400invalid_requestBody requestu nie pasuje do oczekiwanego schematu.
401unauthorizedAPI Key jest brakujacy lub nieprawidlowy.
402insufficient_creditsBrakuje credits do utworzenia zadania.
404not_foundNie znaleziono zadania dla biezacego API Key.
429rate_limitedPrzekroczono limit na minute lub miesieczny limit.
500internal_errorWystapil nieoczekiwany blad wewnetrzny.

Kolejne kroki

  • Przeczytaj Tekst na wideo
  • Przeczytaj Obraz na wideo

Pierwsze kroki

Najszybszy sposob na rozpoczecie pracy z Seedance 2.0.

Tekst na wideo

Generuj wideo z promptow tekstowych za pomoca Seedance 2.0 Open API.

Spis treści

Base URLAuthenticationPrzeplyw integracjiGlowne endpointyAvailable ModelsStatusyModels Endpoint ExampleWebhookiKody bledowKolejne kroki