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.inkAuthentication
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
- Utworz API Key w panelu Seedance.
- Wyslij zadanie przez
POST /api/open/v1/video/generations. - Zapisz zwrocone
requestId. - Odpytuj
GET /api/open/v1/video/generations/{requestId}az do statusu koncowego. - Opcjonalnie skonfiguruj webhook, aby dostawac powiadomienia o zakonczeniu.
Glowne endpointy
| Method | Endpoint | Description |
|---|---|---|
GET | /api/open/v1/models | Zwraca dostepne modele, czasy trwania, proporcje, rozdzielczosci i dane cenowe. |
POST | /api/open/v1/video/generations | Tworzy 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}/cancel | Anuluje zadanie w kolejce lub w trakcie przetwarzania. |
Available Models
| Model | Best for | Supported durations | Resolutions |
|---|---|---|---|
seedance-2.0 | Highest quality, multimodal generation | 4-15 seconds | 480p, 720p, 1080p |
seedance-2.0-fast | Faster turnaround | 4-15 seconds | 480p, 720p, 1080p |
seedance-1.5-pro | Lower-cost fallback workloads | 5 or 10 seconds | 480p, 720p, 1080p |
Supported aspect ratios:
16:99:161:1
Statusy
| Status | Description |
|---|---|
queued | Zadanie zostalo przyjete i czeka w kolejce. |
processing | Generowanie jest obecnie przetwarzane. |
succeeded | Zadanie zakonczylo sie sukcesem i output.url jest dostepny. |
failed | Zadanie zakonczylo sie bledem. Sprawdz error. |
cancelled | Zadanie 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
webhookUrlz 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 status | Error code | Description |
|---|---|---|
400 | invalid_request | Body requestu nie pasuje do oczekiwanego schematu. |
401 | unauthorized | API Key jest brakujacy lub nieprawidlowy. |
402 | insufficient_credits | Brakuje credits do utworzenia zadania. |
404 | not_found | Nie znaleziono zadania dla biezacego API Key. |
429 | rate_limited | Przekroczono limit na minute lub miesieczny limit. |
500 | internal_error | Wystapil nieoczekiwany blad wewnetrzny. |
Kolejne kroki
- Przeczytaj Tekst na wideo
- Przeczytaj Obraz na wideo