Seedance von Volcengine migrieren

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 ändertCopy Anchor Link

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-LebenszyklusCopy Anchor Link

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.

ReferenzseitenCopy Anchor Link

• Aufgabe erstellen (Volc-kompatibel)
• Aufgabe abrufen (Volc-kompatibel)
• Aufgabenliste (Volc-kompatibel)
• Aufgabe abbrechen (Volc-kompatibel)

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-ActionsCopy Anchor Link

Minimales REST-BeispielCopy Anchor Link

curl 'https://api.tokenlab.sh/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Idempotency-Key: $CLIENT_JOB_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.5",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

Materialien und PersonenverifizierungCopy Anchor Link

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.

MigrationschecklisteCopy Anchor Link

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.