> ## 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` во всех примерах этого документа.

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

* Текст-в-видео и генерация по референс-изображениям
* Референс-видео, референс-аудио, управление первым/последним кадром и редактирование видео не поддерживаются
* API асинхронный: при отправке возвращается `generation.task`, результат получается через [эндпоинт статуса видео-задачи](https://docs.toapis.com/docs/ru/api-reference/tasks/video-status.md).

## Аутентификация

**Authorization** `string` *required*

Аутентификация по Bearer Token:

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Параметры запроса

**model** `string` *required* (default: seedance-2-ext)

Публичное имя модели ToAPIs. Всегда указывайте `seedance-2-ext`.

**prompt** `string`

Опишите сцену, движение камеры, действия объекта, стиль и звуковую атмосферу.

**seconds** `integer`

Длительность видео в секундах, от `4` до `15`. Также принимается совместимое поле `duration`; не передавайте оба одновременно.

**size** `string`

Соотношение сторон выходного видео. Поддерживаются: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`. Также принимается совместимое поле `aspect_ratio`.

**resolution** `string` (default: 720p)

Разрешение выходного видео. Фиксированное значение `720p`.

**reference\_image** `string`

Публичный URL одного референс-изображения. Для нескольких изображений используйте `reference_images`.

**reference\_images** `string[]`

Массив URL референс-изображений, максимум `9`. Также можно использовать `image_with_roles` с `role` = `reference_image`.

**callback\_url** `string`

URL обратного вызова ToAPIs по завершении задачи. См. [Task Webhooks](https://docs.toapis.com/docs/ru/api-reference/webhooks/task-webhooks.md).

**client\_business\_id** `string`

Номер заказа или ID бизнес-задачи на стороне клиента. Сохраняется с задачей; также доступен запрос `GET /v1/videos/generations/{client_business_id}`.

**trace\_id** `string`

Пользовательский ID для трассировки запроса.

## Правила комбинации материалов

| Содержимое запроса | Поддержка | Примечание |
| - | -: | - |
| Только промпт | Да | Текст-в-видео |
| Референс-изображения | Да | Максимум 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"
    ]
  }'
```

## Ответ

**id** `string`

ID задачи для запросов статуса.

**client\_business\_id** `string`

Возвращается, если был передан в запросе.

**object** `string`

Всегда `generation.task`.

**model** `string`

Модель, использованная в запросе.

**status** `string`

`queued`, `in_progress`, `completed` или `failed`.

**progress** `integer`

Прогресс задачи от `0` до `100`.

**created\_at** `integer`

Метка времени создания.

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


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