Seedance API für Text-zu-Video-Produktteams

Wenn Ihr Produktteam den schnellsten und sicheren Weg zur Evaluierung des Zugriffs auf die Seedance API sucht, ist der richtige erste Schritt nicht, am ersten Tag den vollständigen Video-Workflow zu bauen. Vielmehr geht es darum, drei Grundlagen mit der kleinsten möglichen Integrationsfläche nachzuweisen:

1. Ihr Flatkey-Key authentifiziert korrekt
2. Ihre App kann https://router.flatkey.ai/v1 aufrufen
3. Ihr Team kann die Anfrage in den Usage Logs sehen, bevor Sie asynchrone Video-Jobs verdrahten

Das ist der reibungsarme Schnellstart, den diese Seite behandelt.

Stand Freitag, 17. Juli 2026 weist Flatkeys öffentlicher Schnellstart Entwickler weiterhin an, Bearer-Authentifizierung, die OpenAI-kompatible Base-URL https://router.flatkey.ai/v1 und POST /v1/chat/completions für den ersten Smoke-Test zu verwenden. Flatkeys Live-Modellkatalog führt außerdem öffentlich seedance-2.5 für Text-zu-Video sowie Bild-zu-Video und seedance-2.0-i2v für Bild-zu-Video auf. Auf Seedances eigener öffentlicher API-Seite wird der Video-Workflow weiterhin als asynchrone Aufgabenerstellung, Statusabfrage, Webhooks und nutzungsbasierte Credits beschrieben.

Diese Kombination ist für das Onboarding wichtig: Das Router-Zugriffsmuster ist einfach, der eigentliche Videoerstellungs-Workflow ist jedoch kein synchroner Chat-Aufruf. Produktteams sollten den Router zunächst mit der kleinsten Anfrage validieren und dann nur das Modell und den Job-Flow austauschen, den sie für die Seedance-Evaluierung benötigen.

Kurze Antwort

Verwenden Sie diese Abfolge, wenn Sie einen überprüfbaren Seedance-Onboarding-Pfad mit möglichst wenigen beweglichen Teilen wünschen.

Schritt	Verwendung	Was es belegt
1. Einen Key erstellen	Flatkey-API-Key, der mit sk-fk- beginnt	Ihr Team verfügt über eine gültige Berechtigung
2. Eine Base-URL setzen	https://router.flatkey.ai/v1	Ihre App verweist auf den gemeinsamen Router und nicht auf einen anbieterspezifischen Endpunkt
3. Den kleinsten Smoke-Test ausführen	POST /v1/chat/completions mit einem einfachen Textmodell	Authentifizierung, Header, Routing und Usage Logs funktionieren
4. Auf den Seedance-Pfad umstellen	Ersetzen Sie das Platzhaltermodell durch die freigegebene Seedance-Modell-ID	Dieselbe Zugriffsebene kann jetzt Ihren Workflow zur Videoevaluierung unterstützen
5. Asynchrone Verarbeitung hinzufügen	Polling- oder Webhook-Logik für Video-Jobs	Ihr Produkt ist bereit für die echte Text-zu-Video-Ausführung

Wenn Sie sich nur eine Sache merken, dann diese: Die erste cURL-Anfrage ist ein Router-Konnektivitätstest, nicht die endgültige Text-zu-Video-Nutzlast.

Bevor Sie beginnen

Sie benötigen vier Dinge:

• Ein Flatkey-Konto
• Einen Flatkey-API-Key
• Etwas vorausbezahltes Guthaben für die Anfrage
• Eine Produktentscheidung darüber, welchen Seedance-Pfad Sie tatsächlich evaluieren möchten

Für die meisten Text-zu-Video-Teams macht der öffentliche Modellkatalog die aktuellen Optionen ausreichend nachvollziehbar, um das Gespräch zu beginnen:

Aktuelles öffentliches Modellsignal auf Flatkey	Beste Verwendung
seedance-2.5	Text-zu-Video-Evaluierung, bei Bedarf zusätzlich Bild-zu-Video
seedance-2.0-i2v	Nur Bild-zu-Video

Verwenden Sie keinen Modellnamen aus einem alten Screenshot oder einer internen Notiz. Prüfen Sie am Veröffentlichungstag das aktuelle Modellverzeichnis oder den Live-Katalog, denn die Verfügbarkeit von Video-Routen kann sich schneller ändern als eine statische Einrichtungsanleitung.

Step 1: create and store the Flatkey API key

In der Flatkey Console erstellen Sie einen API-Schlüssel und speichern ihn als Umgebungsvariable.

export FLATKEY_API_KEY="sk-fk-..."

Dies ist der erste Punkt, an dem Teams vermeidbare Reibung erzeugen. Bewahren Sie den Schlüssel serverseitig auf, nicht im Browser-Code und nicht in einer gemeinsamen lokalen Notiz. Wenn die Evaluation für ein Produktteam und nicht für einen einzelnen Ingenieur erfolgt, verwenden Sie von Anfang an ein Team-eigenes Secret.

Step 2: run the smallest possible router smoke test

Flatkeys aktueller Quickstart verwendet für die erste Anfrage POST /v1/chat/completions. Das ist auch dann der richtige Schritt, wenn Ihr Endziel die Seedance-Videoerzeugung ist, denn so wird die gemeinsame Zugriffsschicht verifiziert, bevor Sie asynchrone Workflow-Komplexität hinzufügen.

curl https://router.flatkey.ai/v1/chat/completions   -H "Authorization: Bearer $FLATKEY_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Reply with the word connected."}
    ]
  }'

Eine erfolgreiche Antwort sagt Ihnen sofort fünf nützliche Dinge:

• der API-Schlüssel ist gültig
• der Authorization: Bearer ...-Header ist korrekt
• die Base-URL ist korrekt
• Ihr Client kann JSON erfolgreich per POST senden
• die Anfrage sollte in den Flatkey Usage Logs mit Token-Zahlen und Kosten erscheinen

Das ist der kleinste überprüfbare Beleg dafür, dass die Zugriffsschicht funktioniert.

Step 3: understand what the smoke test request is actually checking

Der Smoke-Test für Chat-Completions ist absichtlich einfach. Die erforderliche Struktur ist:

Request field	Why it matters
Authorization header	Bestätigt das Bearer-Token-Format
Content-Type: application/json	Bestätigt, dass der Request-Body korrekt geparst wird
model	Bestätigt, dass die Route eine Modell-ID auflösen kann
messages	Bestätigt, dass der Body dem OpenAI-kompatiblen Schema entspricht

Die aktuellen Chat-Completions-Dokumente von Flatkey nennen außerdem die drei Response-Felder, die Produktteams normalerweise zuerst prüfen:

• choices[0].message.content
• model
• usage

Dieses letzte Feld ist besonders nützlich für das Onboarding, weil es Produkt- und Ops-Teams einen gemeinsamen Ort bietet, um zu überprüfen, dass die Anfrage wirklich über den Router geleitet wurde.

Step 4: swap the placeholder model for Seedance evaluation

Sobald der Smoke-Test bestanden ist, behalten Sie dieselben Anmeldedaten und dieselbe Router-Base-URL bei und ändern Sie dann nur die Teile, die für Ihren Video-Workflow spezifisch sind.

Unverändert lassen Sie diese Punkte:

• Authorization: Bearer $FLATKEY_API_KEY
• https://router.flatkey.ai/v1
• Ihr serverseitiges Secret-Handling
• Ihr Prüfpfad für Logs und Abrechnung

Ändern Sie als Nächstes diese Punkte:

Was sich nach dem Smoke-Test ändert	Warum es sich ändert
model	Sie ersetzen das Platzhalter-Textmodell durch die freigegebene Seedance-Modell-ID
Form des Request-Bodys	Die Videoerzeugung benötigt eigene Payload-Felder und nicht nur allein ein Chat-messages-Array
Response-Handling	Video-Workflows geben Job-Status, Assets oder asynchronen Status zurück statt nur sofortigen Text
Produktlogik	Sie benötigen Polling oder einen Webhook, statt den Aufruf wie synchronen Chat zu behandeln

Für eine Text-zu-Video-Produktbewertung ist der sichere Platzhalter am Veröffentlichungstag:

seedance-2.5

Für eine Image-zu-Video-Bewertung ist der aktuelle öffentliche Pfad:

seedance-2.0-i2v

Verwenden Sie diese Namen als Ausgangspunkt für die Entdeckung, nicht als Zusage, dass jeder nachgelagerte Workflow dieselbe identische Payload-Struktur teilt.

Schritt 5: um Seedances asynchronen Video-Workflow herum gestalten

Das ist der Schritt, den die meisten Schnellstarts überspringen.

Die öffentliche API-Seite von Seedance beschreibt den Workflow weiterhin als:

• asynchrone Aufgabenerstellung
• Statusabfrage per Polling
• Webhooks
• nutzungsbasierte Credits

Das bedeutet, dass ein Produktionsteam davon ausgehen sollte, dass der echte Videopfad in der eigenen App mindestens vier Zustände benötigt:

Job-Status	Was Ihre App tun sollte
queued	Den Job erfassen und anzeigen, dass die Anfrage akzeptiert wurde
running	Status abfragen oder auf einen Webhook warten
succeeded	Das Ausgabeartefakt abrufen und Metadaten anhängen
failed	Den Fehler speichern und entscheiden, ob erneut versucht werden soll

Wenn Ihr Team versucht, Seedance wie eine synchrone Chat-Antwort zu behandeln, wirkt die Integration instabil, selbst wenn sich die API normal verhält.

Ein praktischer Onboarding-Ablauf für Produktteams

Wenn Sie den kleinstmöglichen Evaluierungszyklus möchten, verwenden Sie diese Reihenfolge:

1. Erstellen Sie den Flatkey-Schlüssel.
2. Führen Sie den chat/completions-Smoke-Test aus.
3. Überprüfen Sie, ob die Anfrage in den Usage Logs erscheint.
4. Wählen Sie die aktuelle Seedance-Modell-ID, die Sie tatsächlich testen möchten.
5. Implementieren Sie den Seedance-spezifischen asynchronen Request-Flow.
6. Fügen Sie einen Polling-Pfad oder einen Webhook-Pfad hinzu, bevor Sie den Rollout ausweiten.

Das reduziert das Onboarding-Risiko, weil Sie Router-Verifizierung von Video-Workflow-Implementierung trennen.

Fehlerbehebung

401 oder 403 beim ersten cURL-Request

Bedeutet normalerweise, dass der Schlüssel ungültig, abgelaufen oder nicht als Bearer-Token übergeben wird.

Prüfen Sie:

• der Schlüssel beginnt mit sk-fk-
• die Shell-Variable ist wirklich gesetzt
• der Header lautet Authorization: Bearer ...

404 oder Routen-Mismatch

Bedeutet normalerweise, dass Ihre App auf die falsche URL zeigt.

Verwenden Sie:

https://router.flatkey.ai/v1

Richten Sie die Anfrage nicht auf die Marketing-Website und entfernen Sie nicht das Suffix /v1.

Die Anfrage ist erfolgreich, aber die Usage Logs bleiben leer

Flatkeys Schnellstart weist ausdrücklich darauf hin, ein paar Sekunden zu warten und erneut zu suchen. Wenn die Logs immer noch nicht erscheinen, prüfen Sie den Modellnamen, den API-Schlüssel und die Base-URL, die Sie tatsächlich gesendet haben, erneut.

Der Smoke-Test funktioniert, aber der Seedance-Workflow nicht

Das bedeutet in der Regel, dass die Zugriffsebene in Ordnung ist und das Problem jetzt an einer dieser Stellen liegt:

• falsche Seedance-Modell-ID
• falsche Struktur der Video-Nutzdaten
• fehlende asynchrone Polling-Logik
• Webhook-Verarbeitung noch nicht implementiert
• Produktcode geht von einer synchronen Textantwort aus

Das ist Fortschritt, kein Fehlschlag. Sie haben das Problem bereits von Authentifizierung und Routing isoliert.

Wann dieser Schnellstart ausreicht

Dieser Schnellstart reicht aus, wenn Ihr Team folgende Fragen beantworten muss:

• Können wir uns über Flatkey authentifizieren?
• Können wir unseren OpenAI-kompatiblen Client-Pfad wiederverwenden?
• Können Produkt und Betrieb die Anfrage in den Logs sehen?
• Können wir von einem Text-Smoketest zu einer Seedance-Route wechseln, ohne zuerst einen weiteren Provider-Schlüssel hinzuzufügen?

Wenn die Antwort auf diese vier Fragen ja lautet, geht es im nächsten Freigabeschritt meist um den asynchronen Video-Workflow und das Kostenmodell, nicht um die grundlegende Konnektivität.

Wenn Sie vor dem Rollout die Preis-Seite benötigen, sehen Sie sich als Nächstes Flatkeys aktuelle Preisseite an, damit das Team die Evaluierung mit derselben Billing-Oberfläche freigeben kann, die auch in der Produktion verwendet wird.

FAQ

Was ist der schnellste Weg, um den Seedance-API-Zugriff über Flatkey zu testen?

Beginnen Sie mit Flatkeys aktuellem POST /v1/chat/completions-Smoke-Test, um Authentifizierung, Base-URL und Usage Logs zu verifizieren. Nachdem das funktioniert, ersetzen Sie das Platzhaltermodell durch die aktuelle freigegebene Seedance-Modell-ID und bauen Sie den asynchronen Video-Workflow auf.

Erzeugt die erste cURL-Anfrage ein Video?

Nein. Die erste cURL-Anfrage ist ein Konnektivitätstest für den gemeinsamen Router. Sie bestätigt, dass Ihr Schlüssel, Ihre Header, die Base-URL und die Logs funktionieren, bevor Sie video-spezifisches Request-Handling hinzufügen.

Mit welchem Seedance-Modell sollte ein Text-zu-Video-Team beginnen?

Stand Freitag, 17. Juli 2026, listet Flatkeys öffentliches Modellkatalog seedance-2.5 für Text-zu-Video und Bild-zu-Video. Prüfen Sie das aktuelle Modellverzeichnis erneut, bevor Sie es im Produktcode fest verdrahten.

Mit welchem Seedance-Modell sollte ein Bild-zu-Video-Team beginnen?

Stand Freitag, 17. Juli 2026, listet Flatkeys öffentlicher Katalog seedance-2.0-i2v für Bild-zu-Video.

Warum beginnt der Onboarding-Flow mit Chat-Completions statt mit einem Video-Job?

Weil die Chat-Completions-Anfrage der kleinste mögliche Beweis dafür ist, dass Ihr OpenAI-kompatibler Routing-Pfad funktioniert. Sie trennt Authentifizierungs- und Logging-Probleme von Problemen in der Video-Pipeline.

Was sollte ich in der ersten erfolgreichen Antwort prüfen?

Prüfen Sie model, choices[0].message.content und usage und bestätigen Sie dann, dass dieselbe Anfrage in den Usage Logs erscheint.

Was ändert sich, wenn ich vom Smoke-Test zur echten Seedance-Evaluierung wechsle?

Der Schlüssel und die Base-URL bleiben gleich. Die Modell-ID, der Request-Body und die asynchrone Job-Verarbeitung ändern sich.