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 InvalidCredential. 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 Kompatibilitätsendpunkt akzeptiert content[]-Einträge wie text, image_url, video_url, audio_url und draft_task. Bildrollen wie first_frame, last_frame und reference_image bleiben erhalten. callback_url wird noch nicht unterstützt; fragen Sie stattdessen den Aufgabenendpunkt ab.

​
Referenzseiten

​
Task-Actions

​
Minimales Action-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.