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

# Buat tugas (kompatibel Volc)

> Buat tugas Seedance 2.0 dengan body REST bergaya Volc atau permintaan Action.

## Ringkasan

Endpoint ini ditujukan untuk tim yang sudah memakai bentuk tugas Seedance bergaya Volc. Autentikasi memakai TokenLab Bearer API key. ID tugas yang dikembalikan diawali `cgt-`; polling status sampai `status` menjadi `succeeded`, `failed`, `cancelled`, atau `expired`.

Anda juga dapat memanggil dispatcher Action dengan `CreateContentsGenerationsTasks`, `GetContentsGenerationsTask`, `ListContentsGenerationsTasks`, atau `DeleteContentsGenerationsTasks`. `Action` dan `Version` tidak peka huruf besar-kecil. `Version` boleh dihilangkan; jika dikirim harus `2024-01-01`.

`callback_url` tidak diterima pada versi ini. Poll status tugas agar event selesai tidak terlewat.

Lihat juga [Model Video Seedance 2.0](/id/guides/seedance-2-video) dan [Pembuatan Video](/id/guides/video-generation).

## Aturan konten

* Gunakan `type=text` untuk teks prompt.
* `type=image_url` tanpa `role` diperlakukan sebagai frame pertama; Anda juga dapat menetapkan `role=first_frame`.
* Gunakan `role=last_frame` hanya bersama frame pertama.
* Gunakan `role=reference_image`, `reference_video`, atau `reference_audio` untuk media referensi.
* Jangan mencampur input frame pertama/terakhir dengan media referensi dalam satu permintaan.

## Catatan parameter

* `ratio` menerima `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, atau `adaptive`.
* `generate_audio` default-nya `true`; setel `false` untuk video tanpa audio.
* `service_tier=default` diterima. Tugas kompatibel Seedance 2.0 menolak `service_tier=flex`, `frames`, dan `camera_fixed=true`.
* Saat model yang dipilih mendukungnya, `tools` dapat berisi objek seperti `{ "type": "web_search" }`. Entri tool yang salah format ditolak, bukan diabaikan.

## Contoh

```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
  }'
```