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

# 비디오 생성 작업 생성

> Seedance 2.0 New POST /api/v3/contents/generations/tasks

## 소개

Seedance 2.0 공식 미러 비동기 비디오 생성 작업을 제출합니다. 성공 시 작업 `id`를 반환합니다. `content`와 `prompt` 중 최소 하나를 제공해야 합니다.

BytePlus Ark 공식 인터페이스와 요청 본문 및 응답 본문이 완전히 동일합니다.

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token, 예: `Bearer sk-your_token_key`
</ParamField>

<ParamField header="Content-Type" type="string">
  `application/json`
</ParamField>

## 요청 매개변수

<ParamField body="model" type="string" required>
  모델 ID: `seedance-2-0` / `seedance-2-0-fast` / `seedance-2-0-NSFW`
</ParamField>

<ParamField body="content" type="array">
  콘텐츠 배열: `text` / `image_url` / `video_url` / `audio_url`, 각 요소에 `role` 지정 가능 (`first_frame` / `last_frame` / `reference_image` / `reference_video` / `reference_audio`); `prompt`와 중 최소 하나 필수
</ParamField>

<ParamField body="prompt" type="string">
  간소화 작성 방식, `content`와 택일
</ParamField>

<ParamField body="callback_url" type="string">
  작업 상태 변경 시 콜백 주소
</ParamField>

<ParamField body="return_last_frame" type="boolean" default="false">
  마지막 프레임 이미지 반환 여부
</ParamField>

<ParamField body="service_tier" type="string" default="default">
  `default` / `flex`
</ParamField>

<ParamField body="execution_expires_after" type="integer" default="172800">
  작업 만료 시간(초), 범위 `[3600, 259200]`
</ParamField>

<ParamField body="generate_audio" type="boolean" default="true">
  오디오 생성 여부
</ParamField>

<ParamField body="safety_identifier" type="string">
  최종 사용자 고유 식별자(사용자 ID 해시 전달 권장)
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  `480p` / `720p` / `1080p` / `4K` (`seedance-2-0-fast`는 `480p`/`720p`만 지원)
</ParamField>

<ParamField body="ratio" type="string" default="adaptive">
  `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
</ParamField>

<ParamField body="duration" type="integer" default="5">
  초 단위, `[4,15]` 또는 `-1`(자동)
</ParamField>

<ParamField body="seed" type="integer" default="-1">
  랜덤 시드
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  워터마크 추가 여부
</ParamField>

<Note>
  `content[].image_url.url` / `video_url.url` / `audio_url.url`은 세 가지 값을 지원합니다: 공개 URL, Base64 (`data:image/png;base64,...`), `asset://&lt;ASSET_ID&gt;` 자산 라이브러리 참조.
</Note>

## 요청 예제

```bash theme={null}
curl -X POST https://api.gravitex.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'
```

## 응답 예제

```json theme={null}
{
  "id": "cgt-20260708094649-mxfjc"
}
```

다음 단계: [비디오 생성 작업 조회](/ko/api-reference/endpoint/seedance-2.0-new/get-video-generation)