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

# seedance-2-fast-ext 비디오 생성

> seedance-2-fast-ext 모델로 저비용·고속 비디오 생성

<Note>
  **중국 본토 사용자 안내:** 중국 본토 사용자는 `https://toapis.cn` 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 `https://toapis.com` 을 `https://toapis.cn` 로 바꿔 주세요.
</Note>

`seedance-2-fast-ext` 는 Seedance 2.0 패밀리의 프로모션 채널 밸류 모델로, 저비용·고속 생성용입니다:

* 텍스트-투-비디오 및 레퍼런스 이미지 생성
* `480p`, `720p`, `1080p` 출력 지원
* 레퍼런스 비디오, 레퍼런스 오디오, 첫/마지막 프레임 제어, 비디오 편집은 미지원
* API는 비동기 작업입니다: 제출하면 `generation.task` 가 반환되고, 완료 후 [비디오 작업 상태 API](../../tasks/video-status)로 결과를 가져옵니다.

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token으로 인증합니다:

  ```text theme={null}
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## 요청 파라미터

<ParamField body="model" type="string" default="seedance-2-fast-ext" required>
  ToAPIs 공개 모델명. 항상 `seedance-2-fast-ext` 를 사용하세요.
</ParamField>

<ParamField body="prompt" type="string">
  장면, 카메라 움직임, 피사체 동작, 스타일, 사운드 분위기를 설명합니다.
</ParamField>

<ParamField body="seconds" type="integer" default="5">
  출력 비디오 길이(초). `5`, `10`, `15` 만 지원합니다. 호환 필드 `duration` 도 사용할 수 있으며, 둘을 함께 전달하지 마세요.
</ParamField>

<ParamField body="size" type="string">
  출력 화면 비율. `16:9`, `9:16`, `4:3`, `3:4`, `1:1` 을 지원합니다. 호환 필드 `aspect_ratio` 도 사용할 수 있습니다.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  출력 해상도. `480p`, `720p`, `1080p` 를 지원합니다.
</ParamField>

<ParamField body="reference_image" type="string">
  단일 레퍼런스 이미지의 공개 URL. 여러 장일 경우 `reference_images` 를 사용하세요.
</ParamField>

<ParamField body="reference_images" type="string[]">
  레퍼런스 이미지 URL 배열. 최대 `9` 장. `image_with_roles`(`role` 은 `reference_image`)로 명시적으로 전달할 수도 있습니다.
</ParamField>

<ParamField body="callback_url" type="string">
  ToAPIs 작업 완료 콜백 URL. 자세한 내용은 [작업 Webhook](/docs/ko/api-reference/webhooks/task-webhooks)을 참조하세요.
</ParamField>

<ParamField body="client_business_id" type="string">
  고객 측 주문 번호 또는 비즈니스 작업 ID. 작업과 함께 저장되며 `GET /v1/videos/generations/{client_business_id}` 로도 조회할 수 있습니다.
</ParamField>

<ParamField body="trace_id" type="string">
  호출자가 정의하는 트레이스 ID.
</ParamField>

## 에셋 조합 규칙

| 요청 내용 | 지원 | 비고 |
| - | -: | - |
| 프롬프트만 | 예 | 텍스트-투-비디오 |
| 레퍼런스 이미지 | 예 | 최대 9장 |
| 레퍼런스 비디오 / 레퍼런스 오디오 | 아니오 | `seedance-2.5-ext` 를 사용하세요 |
| 첫 / 마지막 프레임 | 아니오 | 프레임 모드 미지원 |

## 요청 예시

### 텍스트-투-비디오

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-fast-ext",
    "prompt": "바위에 부딪히는 파도, 카메라가 천천히 둘러쌈.",
    "seconds": 5,
    "size": "16:9",
    "resolution": "720p"
  }'
```

### 레퍼런스 이미지로 생성

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-fast-ext",
    "prompt": "이미지1의 캐릭터가 눈을 깜빡이며 미소 짓는다.",
    "seconds": 5,
    "size": "9:16",
    "resolution": "480p",
    "reference_images": [
      "https://example.com/avatar.png"
    ]
  }'
```

## 응답

<ResponseField name="id" type="string">상태 조회용 작업 ID.</ResponseField>
<ResponseField name="client_business_id" type="string">요청에 지정한 경우 반환됩니다.</ResponseField>
<ResponseField name="object" type="string">항상 `generation.task` 입니다.</ResponseField>
<ResponseField name="model" type="string">이 요청에 사용된 모델명.</ResponseField>
<ResponseField name="status" type="string">`queued`, `in_progress`, `completed` 또는 `failed`.</ResponseField>
<ResponseField name="progress" type="integer">`0`–`100` 의 작업 진행률.</ResponseField>
<ResponseField name="created_at" type="integer">생성 타임스탬프.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "tsk_vid_xxx",
    "object": "generation.task",
    "model": "seedance-2-fast-ext",
    "status": "in_progress",
    "progress": 10,
    "created_at": 1781577600
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.