Skip to main content
Dieser Leitfaden richtet sich an Anwendungen, die bereits Volcengine-artige Seedance-Requests senden. Action-Namen, Version=2024-01-01, content[], PascalCase-Material-Bodies und der Volcengine-Response-Envelope bleiben erhalten. Geändert werden müssen Endpunkt und Authentifizierung.

​
Was sich ändert

Requests nur mit AK/SK-Signatur liefern 401 AuthenticationError. Action-Clients können POST /?Action=...&Version=2024-01-01 verwenden; POST /api/v3?Action=...&Version=2024-01-01 bleibt verfügbar. REST-Task-Clients verwenden /api/v3/contents/generations/tasks.

​
Request-Format und Task-Lebenszyklus

Wenn Ihre Integration bereits Volc-ähnliche Seedance-Anfragen sendet, können Sie den Kompatibilitätsendpunkt verwenden, statt den Body für /v1/videos/generations umzuformen. Senden Sie Ihren TokenLab API Key als Authorization: Bearer ..., verwenden Sie POST /api/v3/contents/generations/tasks für REST-Erstellung oder /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 für Action-Anfragen. Die Erstellung gibt eine Aufgaben-ID cgt-... zurück; Statusantworten verwenden queued, running, succeeded, failed, cancelled oder expired. Dieser Endpunkt akzeptiert content[]-Einträge wie text, image_url, video_url, audio_url und draft_task. callback_url erhält bei jedem Wechsel zu queued, running, succeeded, failed oder expired dasselbe Abfrageobjekt; succeeded und failed werden nach fünf Sekunden bis zu dreimal wiederholt. Behalten Sie Polling als Rückfallpfad bei.

​
Referenzseiten

Verwenden Sie keine Response-Struct von /v1/tasks/{id} für v3. v1 nutzt pending, processing, completed und failed; v3 nutzt queued, running, succeeded, failed, cancelled und expired. In v3 ist duration eine Zeichenkette und error erscheint nur bei Fehlern. Senden Sie zur Wiederaufnahme nach einem Verbindungsabbruch einen eindeutigen Idempotency-Key mit der REST-Erstellung. Derselbe Body und Key liefern dieselbe cgt-...-ID; ein anderer Body mit demselben Key ergibt 409.

​
Task-Actions

​
Minimales REST-Beispiel

​
Materialien und Personenverifizierung

Derselbe Action-Endpunkt unterstützt auch zehn Material- und Materialgruppenoperationen. PascalCase-Bodies, Filter, Paging, Response-Envelope und zwölf Stunden gültige Material-URLs finden Sie unter Volcengine-kompatible Material-Actions. Für Personenmaterialien sind vor dem Upload zusätzlich Visuelle Verifizierungssitzung erstellen und Ergebnis der visuellen Verifizierung abrufen erforderlich.

​
Migrationscheckliste

  1. Ersetzen Sie den API-Host durch https://api.tokenlab.sh.
  2. Ersetzen Sie die AK/SK-Signatur durch einen TokenLab Bearer API Key.
  3. Behalten Sie Action, Version und Groß-/Kleinschreibung des Bodys bei.
  4. Verwenden Sie für zusammengehörige Material- und Verifizierungsrequests dasselbe ProjectName.
  5. Speichern Sie die von TokenLab zurückgegebenen Task-, Gruppen- und Material-IDs.
  6. Prüfen Sie Erstellen, Polling, Listen und Fehlerantworten vor der Produktionsumstellung.