Bearer-API-Schlüssel
Senden Sie `Authorization: Bearer sk_seedancee2_live_xxxxx` mit jeder Anfrage.
Auf Basis des zugrunde liegenden Seedance 2.0-Modells bündeln und kapseln wir die Fähigkeiten der Upstream-Anbieter und stellen sie als standardisierte öffentliche API bereit.
Integrieren Sie einmal mit `pro`, `fast` und `mini`, während wir Änderungen bei Upstream-Anbietern hinter demselben öffentlichen Vertrag kapseln.
Führen Sie promptbasierte und bildbasierte Videogenerierung über eine API-Oberfläche aus, ohne anbieterabhängige Unterschiede an Kunden weiterzugeben.
Senden Sie eine Generierungsanfrage, fragen Sie den Jobstatus ab oder erhalten Sie einen Webhook, wenn das Video mit einer klaren SeeDanceE2-Antwort bereit ist.
Die öffentliche API verbirgt die Upstream-Anbieter. Entwickler integrieren drei öffentliche Modellnamen, ein Authentifizierungsschema und einen asynchronen Aufgaben-Lebenszyklus.
Senden Sie `Authorization: Bearer sk_seedancee2_live_xxxxx` mit jeder Anfrage.
Erstellen Sie eine asynchrone Generierungsaufgabe, fragen Sie sie per ID ab oder empfangen Sie Abschluss-Callbacks.
Antworten liefern reservierte, abgebuchte und erstattete Credits, damit die Abrechnung prüfbar bleibt.
Für kundenorientierte Clips und standardmäßige Produktionsarbeit.
Für Vorschau-Workflows und wiederholte Prompt-Experimente.
Für leichte Entwürfe und budgetbewusste Generierung.
Erstellen Sie im Workspace einen API-Schlüssel und senden Sie ihn als Bearer-Token: Authorization: Bearer sk_seedancee2_live_xxxxx bei jeder Anfrage.
Die Generierung ist asynchron. Sie senden eine Aufgabe, erhalten eine Aufgaben-ID und fragen dann den Status-Endpoint ab oder registrieren einen Webhook, um bei Fertigstellung benachrichtigt zu werden.
Nur die öffentlichen Stufen pro, fast und mini. Die Plattform leitet jede Anfrage an das bestmögliche verfügbare zugrunde liegende Videomodell weiter, damit Ihre Integration bei Anbieterwechseln nicht bricht.
Die API-Nutzung greift auf dasselbe Credit-Guthaben wie die Web-App zurück. Antworten liefern credits_reserved, credits_charged und credits_refunded, damit jeder Aufruf prüfbar bleibt.
Ja. Senden Sie einen Text-Prompt für Text-zu-Video oder hängen Sie eine Referenzbild-URL für Bild-zu-Video an; die Bildkomposition bleibt erhalten und nur die beschriebene Bewegung wird erzeugt.
SeeDanceE2 stellt eine stabile öffentliche API für die Videogenerierung bereit. Integrationen sollten ausschließlich die öffentlichen Modellnamen pro, fast und mini verwenden; Details der Upstream-Anbieter bleiben hinter dem SeeDanceE2-Vertrag verborgen.
https://api.SeeDanceE2.aiMinimales curl-Beispiel:
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
},
"metadata": {
"customer_job_id": "job_123"
}
}'Minimales JavaScript-Beispiel:
const response = await fetch("https://api.SeeDanceE2.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "mini",
input: {
prompt: "A cinematic drone shot of waves breaking against black volcanic rocks",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
},
metadata: {
customer_job_id: "job_123",
},
}),
});
const result = await response.json();
console.log(result);Minimales Python-Beispiel:
import requests
response = requests.post(
"https://api.SeeDanceE2.ai/v1/videos/generations",
headers={
"Authorization": "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
json={
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
},
"metadata": {
"customer_job_id": "job_123",
},
},
timeout=60,
)
print(response.json())Alle Anfragen verwenden Bearer-Token-Authentifizierung.
Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/jsonSie können den Schlüssel auch über x-api-key senden, empfohlen ist jedoch Authorization: Bearer ....
pro, fast und mini.Wenn Sie bereits einen funktionierenden SeeDanceE2-API-Schlüssel haben, genügt zum Modellwechsel eine Änderung des Feldes model in der Anfrage. Beispiel:
{
"model": "mini"
}wird zu:
{
"model": "fast"
}oder:
{
"model": "pro"
}Dies sind die öffentlichen Modellnamen, die Ihre Integration verwenden sollte.
| Modell | Positionierung | Dauer | Auflösung |
|---|---|---|---|
pro | Produktionsgenerierung in Standardqualität | 4-15 s | 480p, 720p, 1080p |
fast | Schnellere Iteration und Vorschau-Workflows | 4-15 s | 480p, 720p |
mini | Kostengünstigere Generierung | 4-15 s | 480p, 720p |
Neue Integrationen sollten pro, fast und mini verwenden.
Unterstützte Seitenverhältnisse:
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveCredits der öffentlichen API folgen denselben Abrechnungsregeln, die im SeeDanceE2-Produkt sichtbar sind.
Formel:
credits = duration_seconds * per_second_rate * number_of_outputsReferenzbilder, -videos und -audios verursachen derzeit keine zusätzlichen kundenseitigen Aufschläge. Die in der API-Antwort ausgewiesenen reservierten und abgebuchten Credits sind für jede Aufgabe maßgeblich.
Aktuelle Sekundentarife, die den Abrechnungsregeln des SeeDanceE2-Produkts entsprechen:
| Modell | 480p | 720p | 1080p |
|---|---|---|---|
pro | 10 Credits/s | 20 Credits/s | 50 Credits/s |
fast | 8 Credits/s | 16 Credits/s | Nicht unterstützt |
mini | 5 Credits/s | 10 Credits/s | Nicht unterstützt |
Beispiele:
| Szenario | Credits |
|---|---|
mini, 5 s, 720p | 50 |
pro, 4 s, 480p | 40 |
fast, 10 s, 720p | 160 |
pro, 5 s, 720p, 2 Referenzbilder | 100 |
Wenn eine Aufgabe fehlschlägt und erstattungsfähig ist, zeigt die zurückgegebene Status-Payload die erstatteten Credits.
Von der öffentlichen API zurückgegebene Aufgabenstatus:
| Status | Bedeutung |
|---|---|
pending | Angenommen und wartet auf den Start |
processing | Läuft |
completed | Erfolgreich abgeschlossen |
failed | Ohne verwertbares Ergebnis beendet |
POST /v1/videos/generationsFelder auf oberster Anfrageebene:
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
model | string | Ja | Öffentlicher Modellname: pro, fast oder mini |
input | object | Ja | Generierungsparameter |
callback_url | string | Nein | Öffentliche Webhook-URL für Erfolgs- oder Fehler-Callbacks |
metadata | object | Nein | Kundenndefinierte Metadaten, die in Polling- und Webhook-Antworten zurückgegeben werden |
Eingabefelder:
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prompt | string | Ja | Text-Prompt |
generation_type | string | Nein | omni_reference oder first_and_last_frames; Standard omni_reference |
image_urls | string[] | Nein | URLs der Referenzbilder |
video_url | string | Nein | URL eines einzelnen Referenzvideos |
video_urls | string[] | Nein | URLs der Referenzvideos. Nicht zusammen mit video_url senden |
audio_urls | string[] | Nein | URLs der Referenzaudios |
start_image_url | string | Nein | Startbild für first_and_last_frames |
end_image_url | string | Nein | Endbild für first_and_last_frames |
duration | integer | Nein | Ausgabedauer in Sekunden, 4-15; Standard 5 |
resolution | string | Nein | 480p, 720p oder 1080p; verfügbare Auflösungen hängen vom gewählten Modell ab |
aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 oder adaptive |
generate_audio | boolean | Nein | Erzeugt synchronisiertes Audio, sofern unterstützt |
watermark | boolean | Nein | Fordert eine Ausgabe mit Wasserzeichen an |
seed | integer | Nein | Deterministischer Seed |
return_last_frame | boolean | Nein | Fügt das letzte Einzelbild in die Ausgabe-Payload ein |
Vollständiges Beispiel:
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"callback_url": "https://example.com/webhooks/seedancee2",
"input": {
"prompt": "A cinematic tracking shot through a rain-soaked neon market at night",
"image_urls": [
"https://example-cdn.com/reference-1.png",
"https://example-cdn.com/reference-2.png"
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"return_last_frame": true
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}'Erfolgsantwort:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "pending",
"model": "pro",
"credits_reserved": 100,
"created_at": "2026-06-29T10:00:00.000Z"
}
}GET /v1/videos/generations/{id}Polling-Beispiel:
const response = await fetch(
"https://api.SeeDanceE2.ai/v1/videos/generations/vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
{
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
},
}
);
const result = await response.json();
console.log(result);Antwort während der Verarbeitung:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "processing",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Antwort bei Abschluss:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg",
"last_frame_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Antwort bei Fehler:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}GET /v1/videos/generationsUnterstützte Query-Parameter:
| Feld | Typ | Beschreibung |
|---|---|---|
status | string | Filtert nach pending, processing, completed oder failed |
limit | integer | Maximale Anzahl Ergebnisse. Standard 20, Maximum 100 |
Beispiel:
curl "https://api.SeeDanceE2.ai/v1/videos/generations?status=completed&limit=10" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"GET /v1/modelsBeispielantwort:
{
"data": [
{
"id": "pro",
"status": "active",
"resolutions": ["480p", "720p", "1080p"],
"duration": {
"min": 4,
"max": 15
}
}
]
}GET /v1/usageUnterstützte Query-Parameter:
| Feld | Typ | Beschreibung |
|---|---|---|
start | string | Optionaler Filter für die Startzeit im ISO-8601-Format |
end | string | Optionaler Filter für die Endzeit im ISO-8601-Format |
limit | integer | Maximale Anzahl Zeilen der täglichen Zeitachse. Standard 30, Maximum 365 |
Beispiel:
curl "https://api.SeeDanceE2.ai/v1/usage?start=2026-07-01T00:00:00.000Z&end=2026-07-31T23:59:59.999Z&limit=7" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"Beispielantwort:
{
"data": {
"range": {
"start": "2026-07-01T00:00:00.000Z",
"end": "2026-07-31T23:59:59.999Z"
},
"summary": {
"total_jobs": 12,
"pending_jobs": 1,
"processing_jobs": 2,
"completed_jobs": 8,
"failed_jobs": 1,
"credits_charged": 280,
"credits_refunded": 40,
"net_credits": 240
},
"by_model": [
{
"model": "mini",
"total_jobs": 7,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 5,
"failed_jobs": 1,
"credits_charged": 120,
"credits_refunded": 20,
"net_credits": 100
},
{
"model": "pro",
"total_jobs": 5,
"pending_jobs": 1,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 160,
"credits_refunded": 20,
"net_credits": 140
}
],
"timeline": [
{
"date": "2026-07-01",
"total_jobs": 4,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 100,
"credits_refunded": 0,
"net_credits": 100
}
]
}
}Wenn callback_url angegeben ist, sendet SeeDanceE2 eine POST-Anfrage, sobald die Aufgabe completed oder failed erreicht.
Empfohlene Header zur Prüfung:
X-Seedancee2-Event: video.generation.completed
X-Seedancee2-Signature: t=1770000000,v1=...Ist die Webhook-Signierung für Ihr Konto aktiviert, wird der Body so signiert:
payload_to_sign = "{timestamp}.{raw_json_body}"
signature = hex(hmac_sha256(webhook_secret, payload_to_sign))Webhook-Payload bei Abschluss:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Webhook-Payload bei Fehler:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Bilder:
| Anforderung | Wert |
|---|---|
| Formate | JPEG, PNG, WebP, BMP, TIFF, GIF |
| Anzahl | Bis zu 9 Referenzbilder |
first_and_last_frames | Genau 2 Bilder |
Videos:
| Anforderung | Wert |
|---|---|
video_url | 1 |
video_urls | Bis zu 3 |
Audios:
| Anforderung | Wert |
|---|---|
audio_urls | Bis zu 3 |
Fehlerformat:
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}Aktuelle öffentliche Fehlercodes:
| HTTP-Status | Code | Typ | Beschreibung |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | Fehlende oder ungültige Parameter |
| 401 | invalid_api_key | authentication_error | API-Schlüssel fehlt, ist ungültig oder deaktiviert |
| 402 | insufficient_credits | billing_error | Credit-Guthaben zu niedrig |
| 404 | model_not_found | invalid_request_error | Modell existiert nicht oder ist inaktiv |
| 404 | task_not_found | invalid_request_error | Aufgaben-ID existiert nicht |
| 500 | internal_error | api_error | Unerwarteter Serverfehler |
pro, fast und mini.metadata, um Callbacks und Polling-Ergebnisse mit internen Geschäftsdaten zu verknüpfen.