Seedance ist ein Videogenerierungsmodell von ByteDance und wird häufig für Werbematerial, E-Commerce-Kurzvideos und Storyboard-Visualisierungen eingesetzt. Die API unterscheidet sich grundlegend von Textmodellen: Eine Anfrage liefert nicht direkt ein Video, sondern legt zunächst eine Aufgabe an, deren Status anschließend abgefragt wird, bis das Ergebnis zum Download bereitsteht. Wer nach dem Muster von Chat Completions programmiert, bleibt meist schon im ersten Schritt hängen.

Dieser Artikel folgt der technischen Umsetzung: Authentifizierung, Aufgabenübermittlung, Statusabfrage, Parameter, Tests, Kosten und Compliance. Schnittstellenadressen, Modellnamen und Abrechnungsarten ändern sich schnell; maßgeblich sind die offizielle Dokumentation und die Dokumentation auf dieser Website.

Hinweis: Seedance, Doubao und Volcano Engine sind Marken der jeweiligen Rechteinhaber; dieser Artikel dient ausschließlich der technischen Erläuterung. Pfade und Modellnamen in den Beispielen dienen nur der Veranschaulichung und sind vor dem tatsächlichen Aufruf in der offiziellen oder der Dokumentation auf dieser Website zu prüfen. Preise richten sich nach der Preisseite.

1. Wofür die Seedance API geeignet ist

  • Produktvideos und Hauptbildvideos im E-Commerce;
  • Entwürfe für Feed-Werbung und Kurzvideomaterial;
  • Storyboards, Concept-Filme und Stiltests;
  • vertikale Inhalte für soziale Medien;
  • Previsualisierungen für Spiele und Animationen.

Nicht geeignet für: Nachrichtenmaterial mit strenger Faktenanforderung, Porträts realer Personen ohne Einwilligung, rechtlich oder medizinisch sensible Inhalte mit exakten Markenvorgaben. Die Steuerbarkeit von Videogenerierung ist weiterhin schwächer als bei echten Aufnahmen; bei wichtigen Aufträgen vor der Ausstrahlung manuell prüfen.

2. Grundablauf einer asynchronen Aufgabe

Konfiguration lesen → authentifizieren → Generierungsauftrag senden → task_id erhalten
        → Status abfragen (Warteschlange/läuft/erfolgreich/fehlgeschlagen)
        → Erfolg: Video herunterladen oder temporäre URL abrufen
        → Fehler: Fehlercode lesen, Wiederholung oder Abbruch entscheiden

Im Vergleich zu Text-Schnittstellen entstehen drei zusätzliche Kosten: Wartezeit in der Warteschlange, Wiederholungen bei Fehlern und Speicherung der Ergebnisse. Diese drei Punkte müssen in die Architektur einfließen, sonst treten nach dem Livegang Probleme auf – etwa „Anfrage läuft in den Timeout, Aufgabe läuft weiter“ oder „doppeltes Senden führt zu doppelter Abrechnung“.

3. Authentifizierung und Vorbereitung

  1. Kanal prüfen: Zuerst in der Dokumentation auf dieser Website nachsehen, ob die Seedance-Videofunktion freigeschaltet ist, welche Modelle, Dauern und Auflösungen unterstützt werden.
  2. Key erstellen: Im Kontrollzentrum einen eigenen Key anlegen, benannt etwa seedance-test oder seedance-prod.
  3. Modellnamen prüfen: Aus der Preisseite oder Dokumentation kopieren, Versionssuffixe nicht aus dem Gedächtnis ergänzen.
  4. Rückgabeweg klären: Manche Kanäle unterstützen Webhooks, andere nur Polling.
  5. Material vorbereiten: Startbild und Referenzbilder als öffentlich erreichbare URLs bereitstellen oder gemäß Dokumentation hochladen.
  6. Budget setzen: Für den Test-Key eine Obergrenze festlegen, damit beim Debuggen keine hohe Rechnung entsteht.

Die Authentifizierung erfolgt üblicherweise über Authorization: Bearer <API_KEY>, manche Plattformen verwenden jedoch AK/SK-Signaturen oder temporäre Tokens. Maßgeblich ist die jeweilige Dokumentation; das Authentifizierungsverfahren einer Plattform nicht auf eine andere übertragen.

4. Beispiel für die Aufgabenübermittlung

Das folgende Beispiel zeigt eine übliche aufgabenbasierte Anfrage; Pfad und Felder dienen nur der Veranschaulichung:

export SEEDANCE_API_KEY="IHR-SCHLUESSEL"
export BASE_URL="https://IHR-GATEWAY-ODER-OFFIZIELLE-ADRESSE"

curl -X POST "$BASE_URL/contents/generations/tasks" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "content": [
      {"type": "text", "text": "Straßenzug in Shanghai nach dem Regen, langsame Kamerafahrt, filmische Anmutung, 16:9"},
      {"type": "image_url", "image_url": {"url": "https://example.com/first-frame.jpg"}}
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p",
    "watermark": false
  }'

Nach erfolgreicher Übermittlung enthält die Antwort eine Aufgaben-ID. Diese in der Datenbank speichern und mit der Geschäftsnummer verknüpfen; Statusabfrage, Wiederholungen und Abgleich stützen sich darauf.

5. Statusabfrage und Download

curl "$BASE_URL/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

Übliche Zustände sind Warteschlange, läuft, erfolgreich und fehlgeschlagen. Empfehlungen:

  • Abfrageintervall bei 5 Sekunden beginnen und schrittweise auf 15–30 Sekunden erhöhen;
  • ein Gesamtzeitlimit setzen, etwa 10 Minuten, danach als fehlgeschlagen markieren statt unbegrenzt zu warten;
  • die Video-URL in erfolgreichen Antworten ist meist befristet; rechtzeitig in den eigenen Objektspeicher übernehmen;
  • bei fehlgeschlagenen Aufgaben Fehlercode und Anfrageparameter speichern, um den Fall später auszuwerten.

6. Wichtige Parameter

Parameter Funktion Praxisempfehlung
prompt / text Beschreibt Bild, Bewegung, Kamera und Stil Zuerst Motiv, dann Kamera und Licht
Startbild Legt das Ausgangsbild fest Klares Bild ohne Rechtekonflikte verwenden
duration Videodauer Zuerst die kürzeste Stufe testen
resolution Auflösung Zum Testen niedrig, für das Endprodukt höher
ratio Seitenverhältnis Für vertikale Ausspielung 9:16
seed Zufallsseed Fester Seed erleichtert Parametervergleiche
watermark Wasserzeichen Vor kommerzieller Nutzung Plattformregeln prüfen

Parameternamen können sich zwischen Plattformen unterscheiden – mal image, mal image_url, mal Dauer als Zeichenkette. Maßgeblich ist die Dokumentation; den Request-Body eines anderen Anbieters nicht unverändert übernehmen.

7. Checkliste vor dem Livegang

  1. Authentifizierung funktioniert und 401 wird abgefangen.
  2. Aufgaben mit kürzester Dauer und niedrigster Auflösung sind erfolgreich.
  3. Die Aufgaben-ID kommt zuverlässig zurück und ist abfragbar.
  4. Timeout und maximale Wiederholungszahl der Statusabfrage sind gesetzt.
  5. Fehlerursachen sind lesbar und unterscheiden Prüfablehnung von Systemfehlern.
  6. Gültigkeitsdauer der Ergebnis-URL und Übernahme in den Speicher sind getestet.
  7. Die Abrechnung entspricht den Erwartungen; auch geprüft, ob fehlgeschlagene Aufgaben berechnet werden.
  8. Parallele Übermittlungen lösen keine unerwartete Drosselung aus.

8. Kosten schätzen

Videokosten liegen meist deutlich über Textkosten; bei der Schätzung nicht nur den Einzelpreis betrachten:

Kosten pro Video =
  Einzelpreis × Dauer × Auflösungsfaktor
+ Kosten fehlgeschlagener Wiederholungen
+ Speicher und Bandbreite
+ Zeit für die manuelle Prüfung

Die Abrechnung kann nach generierten Sekunden, nach Auflösungsstufe oder nach Video-Tokens erfolgen. Konkrete Einzelpreise stehen in den Modellpreisen. Zuerst 20–50 Videos als kleine Charge erzeugen, Erfolgsquote, durchschnittliche Dauer und Kosten pro Video messen und dann über die Skalierung entscheiden.

9. Inhaltsprüfung und Urheberrechtsrisiken

  • Persönlichkeitsrecht: Für Uploads realer Personen oder erkennbar generierte Personen ist eine Einwilligung erforderlich.
  • Urheberrecht: Referenzbilder, Stile, Musik und Marken können Rechte Dritter berühren.
  • Inhaltsrichtlinien: Gewalt, sexuelle Inhalte, illegale Inhalte und Falschinformationen werden abgelehnt oder entfernt.
  • Irreführung: Werbematerial darf keine Wirkung erzeugen, die nicht zum tatsächlichen Produkt passt.
  • Datensicherheit: Hochgeladene Bilder und Videos können Kundeninformationen enthalten; Anonymisierung und Aufbewahrungsfristen beachten.
  • Kommerzielle Nutzung: Ob generierte Inhalte kommerziell genutzt werden dürfen, hängt von Plattformbedingungen und der Rechteeinräumung am Material ab.

Drei Kontrollstufen empfehlen sich: Materialprüfung vor der Übermittlung, manuelle Stichprobe nach der Generierung, Freigabe durch Marke oder Rechtsabteilung vor der Ausspielung. Eine Prüfablehnung ist kein technischer Fehler; nicht versuchen, sie durch wechselnde Schlüsselwörter wiederholt zu umgehen.

10. Empfehlungen für den stabilen Betrieb

  • Aufgabentabelle in der Datenbank führen mit Übermittlungszeit, Status, Dauer und Kosten;
  • Übermittlung und Statusabfrage trennen, damit nicht eine Anfrage minutenlang synchron wartet;
  • bei 429 und 5xx exponentiellen Backoff verwenden, bei 4xx-Parameterfehlern nicht blind wiederholen;
  • einen Ausweichkanal oder ein Ersatzmodell vorsehen, da Videokanäle in Spitzenzeiten in der Warteschlange stehen können;
  • Erfolgsquote, P95-Dauer und Kosten pro Video überwachen und täglich abgleichen.

Häufige Fragen

Liefert die Seedance API Videos synchron?

Üblicherweise nicht. Videogenerierung läuft meist asynchron: Aufgabe senden, Status abfragen oder Callback abwarten, dann das Ergebnis herunterladen.

Ist der Aufruf aus China direkt möglich?

Das hängt von Kanal, Konto und Compliance-Bedingungen ab. Vor der Nutzung Servicebedingungen, Inhaltsrichtlinien und lokale Vorschriften prüfen.

Wie lange dauert ein Video?

Abhängig von Warteschlange, Dauer, Auflösung und Upstream-Last sind wenige Dutzend Sekunden bis mehrere Minuten üblich. Im Produktivbetrieb Timeouts und Wiederholungen vorsehen.

Werden fehlgeschlagene Aufgaben berechnet?

Die Regeln unterscheiden sich je Plattform. Vor der Integration klären, wie Fehler, Prüfablehnungen und abgebrochene Timeouts abgerechnet werden.

Kann ein eigenes Bild als Startbild dienen?

Die meisten Videomodelle unterstützen das, sofern das Bild für die Plattform erreichbar ist und die entsprechenden Rechte vorliegen. Die genauen Felder stehen in der Dokumentation.

Nächste Schritte

Prüfen Sie zuerst, ob der Seedance-Kanal auf dieser Website freigeschaltet ist, und führen Sie dann eine Aufgabe mit minimaler Konfiguration aus. Für einen einheitlichen Zugang können Sie beim ZSQH AI Gateway einen Key erstellen und die verfügbaren Modelle auf der Seite Modellpreise prüfen.

Weiterlesen: