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

# 작업 생성(Volc 호환)

> Volc 스타일 REST body 또는 Action 요청으로 Seedance 2.0 작업을 생성합니다.

## 개요

이 엔드포인트는 Volc 스타일 Seedance 작업 구조를 이미 사용하는 팀을 위한 것입니다. 인증은 TokenLab Bearer API Key를 사용합니다. 반환되는 작업 ID는 `cgt-`로 시작하며, `status`가 `succeeded`, `failed`, `cancelled`, `expired` 중 하나가 될 때까지 폴링하세요.

Action 디스패처로 `CreateContentsGenerationsTasks`, `GetContentsGenerationsTask`, `ListContentsGenerationsTasks`, `DeleteContentsGenerationsTasks`를 호출할 수도 있습니다. `Action`과 `Version`은 대소문자를 구분하지 않습니다. `Version`은 생략할 수 있으며, 전달할 경우 `2024-01-01`이어야 합니다.

이 버전에서는 `callback_url`을 받지 않습니다. 완료 이벤트를 놓치지 않도록 작업 상태를 폴링하세요.

같이 보기 [Seedance 2.0 비디오 모델](/ko/guides/seedance-2-video) 및 [비디오 생성](/ko/guides/video-generation).

## 콘텐츠 규칙

* 프롬프트 텍스트에는 `type=text`를 사용합니다.
* `role` 없는 `type=image_url`은 첫 프레임으로 처리되며, `role=first_frame`을 명시할 수도 있습니다.
* `role=last_frame`은 첫 프레임과 함께만 사용할 수 있습니다.
* 참조 미디어에는 `role=reference_image`, `reference_video`, `reference_audio`를 사용합니다.
* 하나의 요청에서 첫/마지막 프레임 입력과 참조 미디어를 섞지 마세요.

## 파라미터 참고

* `ratio`는 `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive`를 허용합니다.
* `generate_audio` 기본값은 `true`입니다. 무음 비디오가 필요하면 `false`를 전달하세요.
* `service_tier=default`는 허용됩니다. Seedance 2.0 호환 작업은 `service_tier=flex`, `frames`, `camera_fixed=true`를 거부합니다.
* 선택한 모델이 지원할 때 `tools`에는 `{ "type": "web_search" }` 같은 객체를 전달할 수 있습니다. 잘못된 tool 항목은 무시하지 않고 거부합니다.

## 예시

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