Entwickler-API

Mit SeeDanceE2.ai entwickeln.

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.

model: promodel: fastmodel: mini
Stabiler API-Vertrag

Integrieren Sie einmal mit `pro`, `fast` und `mini`, während wir Änderungen bei Upstream-Anbietern hinter demselben öffentlichen Vertrag kapseln.

Text- und Bild-Workflows

Führen Sie promptbasierte und bildbasierte Videogenerierung über eine API-Oberfläche aus, ohne anbieterabhängige Unterschiede an Kunden weiterzugeben.

Asynchrone Jobs, Polling, Webhooks

Senden Sie eine Generierungsanfrage, fragen Sie den Jobstatus ab oder erhalten Sie einen Webhook, wenn das Video mit einer klaren SeeDanceE2-Antwort bereit ist.

Öffentlicher Vertrag

Eine API-Oberfläche für die Videogenerierung

Die öffentliche API verbirgt die Upstream-Anbieter. Entwickler integrieren drei öffentliche Modellnamen, ein Authentifizierungsschema und einen asynchronen Aufgaben-Lebenszyklus.

Authentifizierung

Bearer-API-Schlüssel

Senden Sie `Authorization: Bearer sk_seedancee2_live_xxxxx` mit jeder Anfrage.

Aufgaben-Lebenszyklus

Senden, Polling, Webhook

Erstellen Sie eine asynchrone Generierungsaufgabe, fragen Sie sie per ID ab oder empfangen Sie Abschluss-Callbacks.

Nutzung und Credits

Reserviert und abgebucht

Antworten liefern reservierte, abgebuchte und erstattete Credits, damit die Abrechnung prüfbar bleibt.

Öffentliche Modellnamen

Nur `pro`, `fast` und `mini` verwenden

pro

Produktionsqualität

Für kundenorientierte Clips und standardmäßige Produktionsarbeit.

480p, 720p, 1080p
fast

Schnellere Iteration

Für Vorschau-Workflows und wiederholte Prompt-Experimente.

480p, 720p
mini

Kostengünstige Tests

Für leichte Entwürfe und budgetbewusste Generierung.

480p, 720p
Fragen zur API

Häufig gestellte Fragen

Wie authentifiziere ich Anfragen an die Videogenerierungs-API?

Erstellen Sie im Workspace einen API-Schlüssel und senden Sie ihn als Bearer-Token: Authorization: Bearer sk_seedancee2_live_xxxxx bei jeder Anfrage.

Ist die API synchron oder asynchron?

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.

Welche Modellnamen kann ich anfordern?

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.

Wie funktioniert die Abrechnung der API?

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.

Kann die API neben Text-zu-Video auch Bild-zu-Video?

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.

Öffentliche Video-API von SeeDanceE2

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.

Basis-URL

https://api.SeeDanceE2.ai

Schnellstart

  1. Fordern Sie einen API-Schlüssel beim SeeDanceE2-Team an.
  2. Legen Sie eine Videogenerierungsaufgabe an.
  3. Fragen Sie die Aufgabe ab oder empfangen Sie einen Webhook bei Abschluss.

Minimales 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())

Authentifizierung

Alle Anfragen verwenden Bearer-Token-Authentifizierung.

Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/json

Sie können den Schlüssel auch über x-api-key senden, empfohlen ist jedoch Authorization: Bearer ....

API-Schlüssel und Modellzugriff

  • Ihr SeeDanceE2-API-Schlüssel wird vom SeeDanceE2-Team oder in Ihrem Profil ausgestellt.
  • Derselbe SeeDanceE2-API-Schlüssel funktioniert für alle öffentlichen Modelle: pro, fast und mini.
  • Für Mini, Fast oder Pro sind keine separaten API-Schlüssel erforderlich.
  • Zugangsdaten der Upstream-Anbieter werden von SeeDanceE2 verwaltet und sind in Kundenanfragen nie erforderlich.

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

Öffentliche Modelle

Dies sind die öffentlichen Modellnamen, die Ihre Integration verwenden sollte.

ModellPositionierungDauerAuflösung
proProduktionsgenerierung in Standardqualität4-15 s480p, 720p, 1080p
fastSchnellere Iteration und Vorschau-Workflows4-15 s480p, 720p
miniKostengünstigere Generierung4-15 s480p, 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, adaptive

Credits

Credits der öffentlichen API folgen denselben Abrechnungsregeln, die im SeeDanceE2-Produkt sichtbar sind.

Formel:

credits = duration_seconds * per_second_rate * number_of_outputs

Referenzbilder, -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:

Modell480p720p1080p
pro10 Credits/s20 Credits/s50 Credits/s
fast8 Credits/s16 Credits/sNicht unterstützt
mini5 Credits/s10 Credits/sNicht unterstützt

Beispiele:

SzenarioCredits
mini, 5 s, 720p50
pro, 4 s, 480p40
fast, 10 s, 720p160
pro, 5 s, 720p, 2 Referenzbilder100

Wenn eine Aufgabe fehlschlägt und erstattungsfähig ist, zeigt die zurückgegebene Status-Payload die erstatteten Credits.

Aufgaben-Lebenszyklus

Von der öffentlichen API zurückgegebene Aufgabenstatus:

StatusBedeutung
pendingAngenommen und wartet auf den Start
processingLäuft
completedErfolgreich abgeschlossen
failedOhne verwertbares Ergebnis beendet

Videoaufgabe erstellen

POST /v1/videos/generations

Felder auf oberster Anfrageebene:

FeldTypErforderlichBeschreibung
modelstringJaÖffentlicher Modellname: pro, fast oder mini
inputobjectJaGenerierungsparameter
callback_urlstringNeinÖffentliche Webhook-URL für Erfolgs- oder Fehler-Callbacks
metadataobjectNeinKundenndefinierte Metadaten, die in Polling- und Webhook-Antworten zurückgegeben werden

Eingabefelder:

FeldTypErforderlichBeschreibung
promptstringJaText-Prompt
generation_typestringNeinomni_reference oder first_and_last_frames; Standard omni_reference
image_urlsstring[]NeinURLs der Referenzbilder
video_urlstringNeinURL eines einzelnen Referenzvideos
video_urlsstring[]NeinURLs der Referenzvideos. Nicht zusammen mit video_url senden
audio_urlsstring[]NeinURLs der Referenzaudios
start_image_urlstringNeinStartbild für first_and_last_frames
end_image_urlstringNeinEndbild für first_and_last_frames
durationintegerNeinAusgabedauer in Sekunden, 4-15; Standard 5
resolutionstringNein480p, 720p oder 1080p; verfügbare Auflösungen hängen vom gewählten Modell ab
aspect_ratiostringNein16:9, 4:3, 1:1, 3:4, 9:16, 21:9 oder adaptive
generate_audiobooleanNeinErzeugt synchronisiertes Audio, sofern unterstützt
watermarkbooleanNeinFordert eine Ausgabe mit Wasserzeichen an
seedintegerNeinDeterministischer Seed
return_last_framebooleanNeinFü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"
  }
}

Videoaufgabe abrufen

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

Videoaufgaben auflisten

GET /v1/videos/generations

Unterstützte Query-Parameter:

FeldTypBeschreibung
statusstringFiltert nach pending, processing, completed oder failed
limitintegerMaximale 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"

Modelle auflisten

GET /v1/models

Beispielantwort:

{
  "data": [
    {
      "id": "pro",
      "status": "active",
      "resolutions": ["480p", "720p", "1080p"],
      "duration": {
        "min": 4,
        "max": 15
      }
    }
  ]
}

Nutzungsübersicht

GET /v1/usage

Unterstützte Query-Parameter:

FeldTypBeschreibung
startstringOptionaler Filter für die Startzeit im ISO-8601-Format
endstringOptionaler Filter für die Endzeit im ISO-8601-Format
limitintegerMaximale 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
      }
    ]
  }
}

Webhooks

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

Eingaberichtlinien

Bilder:

AnforderungWert
FormateJPEG, PNG, WebP, BMP, TIFF, GIF
AnzahlBis zu 9 Referenzbilder
first_and_last_framesGenau 2 Bilder

Videos:

AnforderungWert
video_url1
video_urlsBis zu 3

Audios:

AnforderungWert
audio_urlsBis zu 3

Fehler

Fehlerformat:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

Aktuelle öffentliche Fehlercodes:

HTTP-StatusCodeTypBeschreibung
400invalid_requestinvalid_request_errorFehlende oder ungültige Parameter
401invalid_api_keyauthentication_errorAPI-Schlüssel fehlt, ist ungültig oder deaktiviert
402insufficient_creditsbilling_errorCredit-Guthaben zu niedrig
404model_not_foundinvalid_request_errorModell existiert nicht oder ist inaktiv
404task_not_foundinvalid_request_errorAufgaben-ID existiert nicht
500internal_errorapi_errorUnerwarteter Serverfehler

Hinweise zur Integration

  • Verwenden Sie ausschließlich öffentliche Modellnamen wie pro, fast und mini.
  • Bauen Sie keine Logik auf interne Anbieternamen, interne Aufgaben-IDs oder interne Media-Hosts.
  • Speichern Sie Ihre eigenen metadata, um Callbacks und Polling-Ergebnisse mit internen Geschäftsdaten zu verknüpfen.
  • Nutzen Sie in der Produktion bevorzugt Webhooks für den Abschluss und halten Sie Polling als Fallback bereit.