> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Aufgabe erstellen (Volc-kompatibel)

> Erstellen Sie eine Seedance-2.0-Aufgabe mit einem Volc-ähnlichen REST-Body oder einer Action-Anfrage.

## Ü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](/de/guides/seedance-2-video) und [Videogenerierung](/de/guides/video-generation).

## 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

```bash theme={null}
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
  }'
```