> ## 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-ext — генерация видео

> Генерация видео моделью seedance-2-ext — текст-в-видео и генерация по референс-изображениям

<Note>
  **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.
</Note>

`seedance-2-ext` — промо-модель семейства Seedance 2.0, стандартный льготный тариф:

* Текст-в-видео и генерация по референс-изображениям
* Референс-видео, референс-аудио, управление первым/последним кадром и редактирование видео не поддерживаются
* API асинхронный: при отправке возвращается `generation.task`, результат получается через [эндпоинт статуса видео-задачи](../../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-ext" required>
  Публичное имя модели ToAPIs. Всегда указывайте `seedance-2-ext`.
</ParamField>

<ParamField body="prompt" type="string">
  Опишите сцену, движение камеры, действия объекта, стиль и звуковую атмосферу.
</ParamField>

<ParamField body="seconds" type="integer">
  Длительность видео в секундах, от `4` до `15`. Также принимается совместимое поле `duration`; не передавайте оба одновременно.
</ParamField>

<ParamField body="size" type="string">
  Соотношение сторон выходного видео. Поддерживаются: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`. Также принимается совместимое поле `aspect_ratio`.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Разрешение выходного видео. Фиксированное значение `720p`.
</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">
  URL обратного вызова ToAPIs по завершении задачи. См. [Task Webhooks](/docs/ru/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-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-ext",
    "prompt": "Продукт с изображения 1 медленно вращается для демонстрации.",
    "seconds": 10,
    "size": "1:1",
    "reference_images": [
      "https://example.com/product.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-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.