Zum Hauptinhalt springen

​
Überblick

Diese Endpunkte sind für Teams gedacht, die bereits die Volc-ähnliche Seedance-Aufgabenstruktur verwenden. Die Authentifizierung erfolgt mit einem TokenLab Bearer API Key. Die zurückgegebene Aufgaben-ID beginnt mit cgt-; fragen Sie den Status ab, bis status succeeded, failed, cancelled oder expired ist. Sie können auch den Action-Dispatcher mit CreateContentsGenerationsTasks, GetContentsGenerationsTask, ListContentsGenerationsTasks oder DeleteContentsGenerationsTasks aufrufen. Action und Version sind nicht groß-/kleinschreibungssensitiv. Version kann fehlen; falls angegeben, muss sie 2024-01-01 sein. callback_url wird in dieser Version nicht akzeptiert. Fragen Sie stattdessen den Aufgabenstatus ab, damit Abschlussereignisse nicht stillschweigend verloren gehen. Siehe auch Seedance 2.0 Videomodelle und Videogenerierung.

​
Inhaltsregeln

  • Verwenden Sie type=text für Prompt-Text.
  • type=image_url ohne role wird als erstes Frame behandelt; alternativ setzen Sie role=first_frame.
  • role=last_frame darf nur zusammen mit einem ersten Frame verwendet werden.
  • Verwenden Sie role=reference_image, reference_video oder reference_audio für Referenzmedien.
  • Mischen Sie keine First-/Last-Frame-Eingaben mit Referenzmedien in einer Anfrage.

​
Parameterhinweise

  • ratio akzeptiert 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 oder adaptive.
  • generate_audio ist standardmäßig true; setzen Sie false für ein stummes Video.
  • service_tier=default wird akzeptiert. Seedance-2.0-Kompatibilitätsaufgaben lehnen service_tier=flex, frames und camera_fixed=true ab.
  • Wenn das gewählte Modell es unterstützt, kann tools Objekte wie { "type": "web_search" } enthalten. Fehlerhafte Tool-Einträge werden abgelehnt statt ignoriert.

​
Beispiel

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A cinematic forest at sunset"},
      {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/ref.png"}}
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generate_audio": true
  }'