# Outsee API — полная документация

Базовый адрес: https://api.outsee.io/v1
Аутентификация: Authorization: Bearer <ключ osk_live_…>
Цены: за секунду, в рублях (в скобках — доллары по курсу Outsee).

---

# Введение

Outsee API — доступ к моделям Outsee через один ключ и один баланс.

## Как это устроено

1. **Ключ.** Войдите на outsee.io, примите оферту и выпустите ключ в разделе [«Ключи API»](https://outsee.io/platform/keys).
2. **Баланс.** Пополните баланс в рублях — картой, через СБП или по счёту для организации.
3. **Запрос.** Отправьте `POST` на адрес нужного режима модели, например `https://api.outsee.io/v1/bytedance/seedance-2.5/text-to-video`. В ответ сразу придёт id запроса со статусом `queued`.
4. **Результат.** Опрашивайте `GET https://api.outsee.io/v1/requests/{id}` или передайте `webhook_url` — когда ролик будет готов, придёт уведомление со ссылкой на файл.

## Базовый адрес

```
https://api.outsee.io/v1
```

Все запросы и ответы — JSON в UTF-8. Время — ISO 8601 в UTC.

## Модели и режимы

У каждой модели несколько режимов — это отдельные эндпоинты: `text-to-video`, `image-to-video`, `reference-to-video`, `first-last-frame`, `video-edit`, `multi-shot`, `motion-transfer`, `draft-to-1080p`. Полный список с полями и ценами — в разделе [«Модели»](https://outsee.io/platform/docs/models) и по запросу `GET https://api.outsee.io/v1/models`.

## Что дальше

- [Быстрый старт](https://outsee.io/platform/quickstart) — интеграция за пару минут: три шага или готовый промпт для ИИ-агента.
- [Запросы и статусы](https://outsee.io/platform/docs/requests) — жизненный цикл запроса.
- [Ошибки](https://outsee.io/platform/docs/errors) — коды и что с ними делать.

---

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

Каждый запрос подписывается ключом в заголовке `Authorization`:

```bash
curl https://api.outsee.io/v1/account \
  -H "Authorization: Bearer osk_live_…"
```

Ключи начинаются с `osk_live_`. Выпускаются и отзываются в разделе [«Ключи API»](https://outsee.io/platform/keys). Сам ключ показывается один раз — сохраните его сразу.

## Как хранить ключ

- Только на сервере: в переменной окружения или менеджере секретов. В код браузера и мобильного приложения ключ не попадает — он даёт доступ к балансу.
- Для каждого проекта удобно выпустить отдельный ключ и задать ему месячный лимит трат.
- Если ключ мог утечь — отзовите его и выпустите новый.

## Ошибки доступа

Нет ключа, ключ неверный или отозван — `401`:

```json
{ "error": { "code": "unauthorized", "message": "Нет ключа или ключ неверный либо отозван…" } }
```

---

# Запросы и статусы

Генерация асинхронная: запрос создаётся мгновенно, ролик готовится от десятков секунд до нескольких минут.

## Создание

```bash
curl https://api.outsee.io/v1/bytedance/seedance-2.5/text-to-video \
  -H "Authorization: Bearer $OUTSEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2b7c9e-order-1842" \
  -d '{ "prompt": "Проезд камеры вдоль моря на закате", "duration": 5, "resolution": "720p" }'
```

Ответ `201`:

```json
{
  "id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "object": "request",
  "status": "queued",
  "price": { "rub": "184.23", "usd": "2.0700", "refunded": false },
  "urls": { "status": "https://api.outsee.io/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff" }
}
```

Цена списывается в момент создания. Если запрос завершится ошибкой, деньги вернутся автоматически.

## Ответы на создание

| HTTP | Что значит |
|---|---|
| `201` | Запрос создан и передан в работу. |
| `202` | Запрос создан и оплачен, но подтверждение запуска не успело прийти. Узнавайте статус по `urls.status` как обычно: запрос либо пойдёт в работу, либо завершится с возвратом денег. |
| `4xx` / `5xx` без `request_id` | Запрос не создан, деньги не списывались. |
| `4xx` / `5xx` с `request_id` | Запрос был создан, но модель отказалась его запускать. Он сразу завершён со статусом `failed`, деньги вернулись на баланс; если был указан `webhook_url`, придёт `request.failed`. |

## Статусы

| Статус | Итоговый | Что значит |
|---|---|---|
| `queued` | нет | Запрос принят и ждёт начала работы. |
| `in_progress` | нет | Ролик генерируется. |
| `completed` | да | Готово, ссылка на файл — в `output.video.url`. |
| `failed` | да | Не удалось. Причина — в `error`, деньги возвращены. |
| `nsfw` | да | Отклонено модерацией. Деньги возвращены. |

## Опрос

```bash
curl https://api.outsee.io/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff \
  -H "Authorization: Bearer $OUTSEE_API_KEY"
```

Опрашивайте раз в 5–10 секунд до итогового статуса. Вместо опроса можно передать [`webhook_url`](https://outsee.io/platform/docs/webhooks).

## Результат

```json
{
  "status": "completed",
  "output": {
    "video": {
      "url": "https://outsee.io/f/…",
      "download_url": "https://outsee.io/f/…?download=1",
      "thumbnail_url": "https://outsee.io/f/…?thumb=1",
      "content_type": "video/mp4",
      "duration_seconds": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  },
  "expires_at": "2026-10-26T10:01:12.000Z"
}
```

Ссылка постоянная в пределах срока хранения (30 дней). Храните файл у себя, если он нужен дольше.

## Список запросов

`GET https://api.outsee.io/v1/requests?limit=20&status=completed` — новые сверху. Для следующей страницы передайте `before` = `next_before` из ответа.

## Оценка цены

`POST https://api.outsee.io/v1/estimate/{модель}/{режим}` с тем же телом, что и запрос, проверяет его целиком (включая файлы по ссылкам) и называет цену — без списания.

## Черновик Seedance 2.5

С `"resolution": "draft"` Seedance 2.5 делает черновик в 480p по цене 480p. В течение 24 часов его можно довести до 1080p с тем же содержанием: `POST https://api.outsee.io/v1/bytedance/seedance-2.5/draft-to-1080p` с `{ "request_id": "<id черновика>" }`. Доводка стоит как тот же ролик сразу в 1080p. В ответе на готовый черновик есть поле `draft` со сроком.

---

# Входные файлы

Файлы передаются ссылками в полях `image_url`, `end_image_url`, `image_urls`, `video_url`, `video_urls`, `audio_urls`.

## Публичная ссылка

Любая ссылка https, которая открывается без входа. Мы скачиваем файл сами. Ограничения:

| Вид | Размер | Форматы |
|---|---|---|
| Изображения | до 20 МБ, до 100 мегапикселей | JPEG, PNG, WebP, HEIC |
| Видео | до 200 МБ | MP4, MOV (WebM модели не принимают) |
| Аудио | до 50 МБ | MP3, WAV, M4A; AAC, OGG и FLAC принимаются и перекодируются в MP3 |

## Загрузка к нам

Если файла нет по публичной ссылке, загрузите его:

```bash
# 1. Получите адрес загрузки
curl https://api.outsee.io/v1/files \
  -H "Authorization: Bearer $OUTSEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content_type": "image/jpeg", "filename": "hero.jpg", "size_bytes": 482133 }'
```

`size_bytes` — точный размер файла в байтах. Он входит в подпись адреса загрузки: файл другого размера хранилище не примет.

```json
{
  "id": "file_1842",
  "file_url": "https://outsee.io/f/u1842-…",
  "upload": { "url": "https://…", "method": "PUT", "headers": { "Content-Type": "image/jpeg", "Content-Length": "482133" }, "expires_at": "…" }
}
```

```bash
# 2. Загрузите файл по адресу upload.url (curl сам поставит Content-Length по размеру файла)
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/jpeg" --upload-file hero.jpg
```

Дальше передавайте `file_url` в поле запроса. Адрес загрузки действует час, загруженный файл хранится 30 дней. `content_type` — один из: `image/jpeg`, `image/png`, `image/webp`, `image/heic`, `video/mp4`, `video/quicktime`, `audio/mpeg`, `audio/wav`, `audio/mp4`, `audio/aac`, `audio/ogg`, `audio/flac`.

## Готовые результаты

Ссылку на готовый ролик (`output.video.url`) можно передать во вход другого запроса — например, чтобы продолжить или поправить ролик.

## Референсы в промпте

В режимах `reference-to-video` на файлы ссылаются по порядку: «женщина с изображения 1», «движение камеры как в видео 1». Порядок — как в массиве.

---

# Вебхуки

Передайте в теле запроса `webhook_url` — адрес https на вашем сервере. Когда запрос завершится (`completed`, `failed` или `nsfw`), туда придёт `POST`:

```json
{
  "event": "request.completed",
  "delivery_id": "1842",
  "created_at": "2026-09-26T10:01:13.000Z",
  "data": { "id": "d7e6c0f3-…", "status": "completed", "output": { "video": { "url": "https://outsee.io/f/…" } } }
}
```

События: `request.completed` и `request.failed` (включает `nsfw`). В `data` — то же, что отдаёт `GET /requests/{id}`.

## Заголовки

| Заголовок | Значение |
|---|---|
| `Outsee-Event` | Тип события |
| `Outsee-Request-Id` | id запроса |
| `Outsee-Delivery-Id` | id доставки — одинаковый у повторов |
| `Outsee-Signature` | `t=<unix-время>,v1=<подпись>` |

## Проверка подписи

Подпись — HMAC-SHA256 от строки `<t>.<тело запроса>` секретом из раздела [«Ключи API»](https://outsee.io/platform/keys). Считайте её от тела как оно пришло, до разбора JSON. Отклоняйте уведомления старше 5 минут.

```javascript
import crypto from "node:crypto";

function verifyOutseeSignature(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  const given = Buffer.from(parts.v1 || "");
  return fresh && given.length === expected.length && crypto.timingSafeEqual(Buffer.from(expected), given);
}
```

## Доставка и повторы

- Ответьте любым `2xx` в течение 10 секунд — доставка засчитана.
- Сеть, `5xx`, `408`, `409`, `425`, `429` — повторим: через 30 секунд, 2 и 10 минут, 30 минут, 1, 2, 4 и 8 часов.
- Остальные `4xx` и переадресации `3xx` — постоянный отказ, повторов не будет. Указывайте конечный адрес без переадресаций.
- Кнопка проверки адреса в разделе «Ключи API» шлёт подписанное событие с полем `"test": true` и нулевым id запроса — такие события не обрабатывайте как настоящие.
- Возможны повторные доставки одного события — отсеивайте дубли по id запроса и статусу.
- Историю доставок видно в карточке запроса в разделе [«Запросы»](https://outsee.io/platform/requests).

---

# Идемпотентность

Сеть рвётся: запрос мог дойти, а ответ — нет. Чтобы повтор не создал второй ролик и не списал деньги дважды, передавайте заголовок `Idempotency-Key`:

```bash
-H "Idempotency-Key: order-1842-video"
```

- Ключ — от 8 до 128 печатных символов ASCII: UUID или ваш номер заказа.
- Повтор с тем же ключом возвращает первый запрос с заголовком `Idempotent-Replayed: true` — без новой генерации и списания.
- Если первый запрос ещё создаётся, повтор получит `409 idempotency_conflict` — повторите через пару секунд.
- Если первый запрос не был создан или модель отказалась его запускать (ответ с ошибкой), ключ свободен: повтор с ним создаёт запрос заново.
- Ключ действует для аккаунта навсегда: новый ролик — новый ключ.

---

# Ошибки

Ошибка запроса — JSON с кодом и понятным текстом:

```json
{ "error": { "code": "invalid_request", "message": "Поле «duration» не больше 30.", "field": "duration" } }
```

Решения принимайте по `code`, текст — для людей.

| HTTP | code | Что делать |
|---|---|---|
| 400 | `invalid_request`, `invalid_json` | Исправить запрос: поле указано в `field`. |
| 401 | `unauthorized` | Проверить ключ. |
| 402 | `insufficient_balance` | Пополнить баланс. |
| 402 | `key_limit_reached` | Поднять месячный лимит ключа или взять другой ключ. |
| 403 | `account_suspended` | Написать в поддержку. |
| 404 | `not_found`, `unknown_endpoint` | Проверить id или адрес режима. |
| 409 | `idempotency_conflict`, `draft_in_progress` | Повторить позже. |
| 410 | `draft_expired` | Срок доводки черновика истёк. |
| 429 | `concurrency_limit` | Дождаться завершения запросов в работе. |
| 413 | `invalid_request` | Тело запроса больше 1 МБ — файлы передавайте ссылками. |
| 429 | `rate_limited` | Повторить через `Retry-After` секунд. |
| 500 | `internal_error` | Повторить с тем же `Idempotency-Key`. |
| 503 | `model_unavailable` | Модель временно недоступна — позже или другая модель. |

## Ошибки генерации

Запрос, принятый в работу, может завершиться статусом `failed` или `nsfw`. Причина — в поле `error`:

| code | Что значит |
|---|---|
| `content_policy` | Описание или файлы не прошли модерацию. |
| `input_rejected` | Модель не смогла работать с входными файлами. |
| `invalid_input` | Параметры не подошли модели. |
| `timeout` | Генерация не завершилась вовремя. |
| `generation_failed` | Сбой генерации — можно повторить. |

Во всех этих случаях деньги за запрос возвращаются на баланс автоматически (`price.refunded: true`).

В каждом ответе есть заголовок `X-Outsee-Trace-Id` — приложите его и id запроса, если пишете в поддержку.

---

# Лимиты

## Одновременные запросы

Сколько запросов аккаунта может быть в статусах `queued` и `in_progress` одновременно. Лимит растёт с суммой пополнений за всё время:

| Пополнено всего | Одновременно |
|---|---|
| с первого пополнения | 5 |
| от 10 000 ₽ | 10 |
| от 50 000 ₽ | 15 |
| от 100 000 ₽ | 20 |

Нужно больше — напишите нам в Telegram [@hello_outsee](https://t.me/hello_outsee): подберём лимит под вашу нагрузку.

При превышении — `429 concurrency_limit` с полями `active` и `limit`. Дождитесь завершения любого запроса.

## Частота

На аккаунт — до 60 запросов в минуту на создание (сюда же входят оценка цены и загрузка файлов) и до 600 на чтение (статусы, списки). Лимит общий для всех ключей аккаунта. Отдельно с одного IP-адреса — до 20 запросов в секунду с коротким запасом. Сверх — `429 rate_limited` и заголовок `Retry-After`.

## Размер запроса

Тело запроса — до 1 МБ. Файлы передавайте ссылками.

Нужно больше — [напишите нам](https://t.me/hello_outsee).

---

# Цены и оплата

## Цена запроса

Оплачиваются секунды готового ролика по ставке модели и разрешения. У Wan 3.0 и MiniMax секунды видео на входе оплачиваются отдельно по своей ставке. У Seedance с видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика — выходит примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее. Ставки — на странице [«Цены»](https://outsee.io/platform/pricing) и в `GET https://api.outsee.io/v1/models`.

Цены заданы в долларах за секунду; списание — в рублях по курсу Outsee в момент запроса, с округлением вверх до копейки. Поэтому рублёвые цены могут меняться вместе с курсом доллара; стоимость уже созданного запроса не меняется. Цена конкретного запроса видна заранее: `POST https://api.outsee.io/v1/estimate/…`.

## Возвраты

Неудачные запросы и отказы модерации не оплачиваются: деньги возвращаются на баланс автоматически.

## Баланс

- Пополнение картой, через СБП, SberPay или зарубежной картой — в разделе [«Баланс и оплата»](https://outsee.io/platform/billing).
- Баланс отдельный от токенов и подписок на сайте Outsee.
- Каждое пополнение действует 12 месяцев с даты зачисления. Запросы оплачиваются сначала из пополнений с ближайшим сроком; неизрасходованный к концу срока остаток пополнения сгорает. Возврат за неудавшийся запрос возвращается в то же пополнение, а если его срок уже истёк — действует ещё 30 дней. Сроки видны в разделе «Баланс и оплата» и в `GET https://api.outsee.io/v1/account` (поле `funds`).
- Автопополнение: «если баланс ниже X — пополнить на Y» с сохранённой карты, с суточным потолком.
- Месячный лимит трат на каждый ключ.

## Для организаций и ИП

Укажите реквизиты в разделе «Баланс и оплата» и выставьте счёт на пополнение: его можно распечатать или сразу отправить бухгалтеру на почту. За каждый месяц автоматически формируется акт на сумму оказанных услуг (запросы за вычетом возвратов). Исполнитель — российский ИП, цены и документы без НДС.

## Хранение

Готовые файлы и загруженные входные файлы хранятся 30 дней, затем удаляются.

---

# Для ИИ-агентов

Вся документация и описание каждой модели доступны в текстовом виде — удобно дать их ИИ-агенту (Claude, ChatGPT, Cursor), который пишет интеграцию.

- [https://outsee.io/platform/llms.txt](https://outsee.io/platform/llms.txt) — краткое оглавление со ссылками.
- [https://outsee.io/platform/llms-full.txt](https://outsee.io/platform/llms-full.txt) — всё целиком: правила, все модели, режимы, поля и цены.
- [https://outsee.io/platform/openapi.json](https://outsee.io/platform/openapi.json) — спецификация OpenAPI 3.1.

На каждой странице модели и документации есть кнопка «Скопировать для LLM» — markdown страницы в буфер обмена.

Готовый промпт для агента, который подключит Outsee API к вашему проекту, — на странице [«Быстрый старт»](https://outsee.io/platform/quickstart).

---

# Модели и режимы

## Seedance 2.5 (ByteDance)

Самая сильная видео-модель в каталоге. Держит героя, товар и стиль по референсам, снимает ролики до 30 секунд в 1080p со звуком, умеет править готовое видео и продолжать его. Черновик в 480p можно довести до 1080p с тем же содержанием.

Идентификатор модели: `bytedance/seedance-2.5`. Режимы: `text-to-video`, `image-to-video`, `reference-to-video`, `video-edit`, `draft-to-1080p`.

### Seedance 2.5 — Текст → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.5/text-to-video`

Ролик по описанию: до 30 секунд, со звуком, в 480p–1080p.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 15 000 символов. (до 15000 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 30. (4–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, draft. draft — черновик в 480p по цене 480p: в течение 24 часов его можно довести до 1080p тем же содержанием через режим draft-to-1080p. (одно из: `480p`, `720p`, `1080p`, `draft`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 480p и черновик, за секунду ролика — 19.44 ₽ ($0.2160); 720p, за секунду ролика — 37.26 ₽ ($0.4140); 1080p, за секунду ролика — 87.48 ₽ ($0.9720).

### Seedance 2.5 — Фото → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.5/image-to-video`

Оживляет изображение: ролик начинается с вашего кадра, по желанию заканчивается вторым. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 15 000 символов. (до 15000 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 30. (4–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, draft. draft — черновик в 480p по цене 480p: в течение 24 часов его можно довести до 1080p тем же содержанием через режим draft-to-1080p. (одно из: `480p`, `720p`, `1080p`, `draft`; по умолчанию `720p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "720p"
}
```

Цена (за секунду): 480p и черновик, за секунду ролика — 19.44 ₽ ($0.2160); 720p, за секунду ролика — 37.26 ₽ ($0.4140); 1080p, за секунду ролика — 87.48 ₽ ($0.9720).

### Seedance 2.5 — Видео по референсам

`POST https://api.outsee.io/v1/bytedance/seedance-2.5/reference-to-video`

Ролик по референсам: до 30 изображений, 10 видео и 10 аудио. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «женщина с изображения 1», «движение камеры как в видео 1». До 15 000 символов. (до 15000 символов) |
| `image_urls` | string[] (URL) | нет | До 30 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 30) |
| `video_urls` | string[] (URL) | нет | До 10 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 30 сек. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее. (до 10) |
| `audio_urls` | string[] (URL) | нет | До 10 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 2 до 30 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 10) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 30. (4–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, draft. draft — черновик в 480p по цене 480p: в течение 24 часов его можно довести до 1080p тем же содержанием через режим draft-to-1080p. (одно из: `480p`, `720p`, `1080p`, `draft`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, auto. auto — формат подбирается по референсам. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`, `auto`; по умолчанию `auto`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "auto",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): 480p и черновик, за секунду ролика — 19.44 ₽ ($0.2160); 720p, за секунду ролика — 37.26 ₽ ($0.4140); 1080p, за секунду ролика — 87.48 ₽ ($0.9720); 480p и черновик с видео на входе, за секунду ролика — 11.86 ₽ ($0.1318); 480p и черновик с видео на входе, за секунду видео на входе (не меньше длины ролика) — 11.86 ₽ ($0.1318); 720p с видео на входе, за секунду ролика — 22.73 ₽ ($0.2525); 720p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 22.73 ₽ ($0.2525); 1080p с видео на входе, за секунду ролика — 53.36 ₽ ($0.5929); 1080p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 53.36 ₽ ($0.5929).

### Seedance 2.5 — Правка видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.5/video-edit`

Правит готовый ролик по описанию: заменить героя, одежду, фон, время суток. Длина, формат и звук берутся из исходника.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Что изменить в ролике: «замени куртку на красную», «перенеси действие на ночную улицу». До 15 000 символов. (до 15000 символов) |
| `video_url` | string (URL) | да | Ролик, который нужно изменить: MP4 или MOV длиной от 4 до 30 сек. |
| `image_urls` | string[] (URL) | нет | Необязательно. До 30 изображений того, что должно появиться в ролике: новая одежда, товар, герой. (до 30) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, draft. draft — черновик в 480p по цене 480p: в течение 24 часов его можно довести до 1080p тем же содержанием через режим draft-to-1080p. (одно из: `480p`, `720p`, `1080p`, `draft`; по умолчанию `720p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "video_url": "https://example.com/source.mp4",
  "resolution": "720p"
}
```

Цена (за секунду): Правка 480p, за секунду ролика — 29.16 ₽ ($0.3240); Правка 720p, за секунду ролика — 55.08 ₽ ($0.6120); Правка 1080p, за секунду ролика — 126.36 ₽ ($1.4040).

### Seedance 2.5 — Черновик → 1080p

`POST https://api.outsee.io/v1/bytedance/seedance-2.5/draft-to-1080p`

Доводит черновик до 1080p с тем же содержанием: та же сцена, движение и звук. Доступно 24 часа после готовности черновика.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `request_id` | string (UUID) | да | id готового запроса Seedance 2.5, созданного с resolution: "draft". Цена — как у той же работы сразу в 1080p. |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
}
```

Цена (за секунду): 1080p, за секунду ролика — 87.48 ₽ ($0.9720); 1080p с видео на входе, за секунду ролика — 53.36 ₽ ($0.5929); 1080p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 53.36 ₽ ($0.5929); Правка 1080p, за секунду ролика — 126.36 ₽ ($1.4040).


---

## Kling 3.0 (Kuaishou)

Флагман Kling: реалистичное движение, до 4K, первый и последний кадр, нативный звук и мультишот — до шести сцен с отдельными описаниями в одном ролике.

Идентификатор модели: `kuaishou/kling-3.0`. Режимы: `text-to-video`, `image-to-video`, `multi-shot`.

### Kling 3.0 — Текст → видео

`POST https://api.outsee.io/v1/kuaishou/kling-3.0/text-to-video`

Ролик по описанию: от 3 до 15 секунд, до 4K.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 3 до 15. (3–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p, 4k. (одно из: `720p`, `1080p`, `4k`; по умолчанию `1080p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 1:1. (одно из: `16:9`, `9:16`, `1:1`; по умолчанию `16:9`) |
| `generate_audio` | boolean | нет | Нативный звук: речь, шумы, музыка. Цена со звуком выше. (по умолчанию `false`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": false
}
```

Цена (за секунду): 720p, за секунду — 7.00 ₽ ($0.0778); 1080p, за секунду — 11.38 ₽ ($0.1264); 4K, за секунду — 28.43 ₽ ($0.3159); 720p со звуком, за секунду — 13.12 ₽ ($0.1458); 1080p со звуком, за секунду — 17.50 ₽ ($0.1944); 4K со звуком, за секунду — 34.55 ₽ ($0.3839).

### Kling 3.0 — Фото → видео

`POST https://api.outsee.io/v1/kuaishou/kling-3.0/image-to-video`

Оживляет изображение: по желанию с последним кадром. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 3 до 15. (3–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p, 4k. (одно из: `720p`, `1080p`, `4k`; по умолчанию `1080p`) |
| `generate_audio` | boolean | нет | Нативный звук: речь, шумы, музыка. Цена со звуком выше. (по умолчанию `false`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "1080p",
  "generate_audio": false
}
```

Цена (за секунду): 720p, за секунду — 7.00 ₽ ($0.0778); 1080p, за секунду — 11.38 ₽ ($0.1264); 4K, за секунду — 28.43 ₽ ($0.3159); 720p со звуком, за секунду — 13.12 ₽ ($0.1458); 1080p со звуком, за секунду — 17.50 ₽ ($0.1944); 4K со звуком, за секунду — 34.55 ₽ ($0.3839).

### Kling 3.0 — Мультишот

`POST https://api.outsee.io/v1/kuaishou/kling-3.0/multi-shot`

Несколько сцен в одном ролике: у каждой своё описание и длительность, вместе до 15 секунд.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `shots` | object[] | да | От 2 до 6 сцен: { "prompt": описание до 400 символов, "duration": целые секунды, не меньше 3 }. Сумма длительностей — не больше 15 сек. (2–6 сцен) |
| `image_url` | string (URL) | нет | Необязательно. Изображение, с которого начнётся первая сцена. |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p, 4k. (одно из: `720p`, `1080p`, `4k`; по умолчанию `1080p`) |
| `generate_audio` | boolean | нет | Нативный звук: речь, шумы, музыка. Цена со звуком выше. (по умолчанию `false`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "shots": [
    {
      "prompt": "Общий план: утренний город, камера медленно опускается к кофейне",
      "duration": 5
    },
    {
      "prompt": "Крупный план: бариста наливает латте-арт",
      "duration": 5
    }
  ],
  "resolution": "1080p",
  "generate_audio": false
}
```

Цена (за секунду): 720p, за секунду — 7.00 ₽ ($0.0778); 1080p, за секунду — 11.38 ₽ ($0.1264); 4K, за секунду — 28.43 ₽ ($0.3159); 720p со звуком, за секунду — 13.12 ₽ ($0.1458); 1080p со звуком, за секунду — 17.50 ₽ ($0.1944); 4K со звуком, за секунду — 34.55 ₽ ($0.3839).


---

## Wan 3.0 (Alibaba)

Длинные ролики до 30 секунд со звуком в трёх разрешениях, референсы героя, движения и голоса, первый и последний кадр. Одна из самых выгодных моделей для длинного контента.

Идентификатор модели: `alibaba/wan-3.0`. Режимы: `text-to-video`, `first-last-frame`, `reference-to-video`.

### Wan 3.0 — Текст → видео

`POST https://api.outsee.io/v1/alibaba/wan-3.0/text-to-video`

Ролик по описанию: от 2 до 30 секунд со звуком.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 20 000 символов. (до 20000 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 2 до 30. (2–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p. (одно из: `480p`, `720p`, `1080p`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 480p, за секунду ролика — 8.10 ₽ ($0.0900); 720p, за секунду ролика — 16.20 ₽ ($0.1800); 1080p, за секунду ролика — 32.40 ₽ ($0.3600).

### Wan 3.0 — Первый и последний кадр

`POST https://api.outsee.io/v1/alibaba/wan-3.0/first-last-frame`

Ролик между двумя кадрами: модель сама придумывает переход от первого к последнему.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 20 000 символов. (до 20000 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | да | Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 2 до 30. (2–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p. (одно из: `480p`, `720p`, `1080p`; по умолчанию `720p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "end_image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "720p"
}
```

Цена (за секунду): 480p, за секунду ролика — 8.10 ₽ ($0.0900); 720p, за секунду ролика — 16.20 ₽ ($0.1800); 1080p, за секунду ролика — 32.40 ₽ ($0.3600).

### Wan 3.0 — Видео по референсам

`POST https://api.outsee.io/v1/alibaba/wan-3.0/reference-to-video`

Ролик по референсам: до 10 изображений, 5 видео и 5 аудио. Видео на входе и ролик вместе — не длиннее 30 секунд.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «героиня с изображения 1». До 20 000 символов. (до 20000 символов) |
| `image_urls` | string[] (URL) | нет | До 10 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 10) |
| `video_urls` | string[] (URL) | нет | До 5 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 15 сек. (до 5) |
| `audio_urls` | string[] (URL) | нет | До 5 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 1 до 15 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 5) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 2 до 30. (2–30; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p. (одно из: `480p`, `720p`, `1080p`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, auto. auto — формат подбирается по референсам. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `auto`; по умолчанию `auto`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "auto",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): 480p, за секунду ролика — 8.10 ₽ ($0.0900); 720p, за секунду ролика — 16.20 ₽ ($0.1800); 1080p, за секунду ролика — 32.40 ₽ ($0.3600); 480p, за секунду видео на входе — 8.10 ₽ ($0.0900); 720p, за секунду видео на входе — 16.20 ₽ ($0.1800); 1080p, за секунду видео на входе — 32.40 ₽ ($0.3600).


---

## Seedance 2.0 (ByteDance)

Проверенная рабочая лошадка для рекламы и соцсетей. Ролики до 15 секунд со звуком, оживление кадра, первый и последний кадр, референсы героя и движения. Режим fast для черновиков, quality — для финала вплоть до 4K.

Идентификатор модели: `bytedance/seedance-2.0`. Режимы: `text-to-video`, `image-to-video`, `reference-to-video`.

### Seedance 2.0 — Текст → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.0/text-to-video`

Ролик по описанию: до 15 секунд со звуком.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 500 символов. (до 7500 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, 4k. (одно из: `480p`, `720p`, `1080p`, `4k`; по умолчанию `720p`) |
| `quality` | string | нет | fast — быстрее и дешевле, quality — детальнее. 1080p и 4K доступны только в quality. (одно из: `fast`, `quality`; по умолчанию `fast`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "quality": "fast",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): Fast 480p, за секунду — 8.95 ₽ ($0.0994); Fast 720p, за секунду — 14.90 ₽ ($0.1656); Quality 480p, за секунду — 13.41 ₽ ($0.1490); Quality 720p, за секунду — 22.36 ₽ ($0.2484); Quality 1080p, за секунду — 59.62 ₽ ($0.6624); Quality 4K, за секунду — 119.23 ₽ ($1.3248).

### Seedance 2.0 — Фото → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.0/image-to-video`

Оживляет изображение: ролик начинается с вашего кадра, по желанию заканчивается вторым.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 500 символов. (до 7500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, 4k. (одно из: `480p`, `720p`, `1080p`, `4k`; по умолчанию `720p`) |
| `quality` | string | нет | fast — быстрее и дешевле, quality — детальнее. 1080p и 4K доступны только в quality. (одно из: `fast`, `quality`; по умолчанию `fast`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "720p",
  "quality": "fast"
}
```

Цена (за секунду): Fast 480p, за секунду — 8.95 ₽ ($0.0994); Fast 720p, за секунду — 14.90 ₽ ($0.1656); Quality 480p, за секунду — 13.41 ₽ ($0.1490); Quality 720p, за секунду — 22.36 ₽ ($0.2484); Quality 1080p, за секунду — 59.62 ₽ ($0.6624); Quality 4K, за секунду — 119.23 ₽ ($1.3248).

### Seedance 2.0 — Видео по референсам

`POST https://api.outsee.io/v1/bytedance/seedance-2.0/reference-to-video`

Ролик по референсам: до 8 изображений, 3 видео и 3 аудио. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «герой с изображения 1». До 7 500 символов. (до 7500 символов) |
| `image_urls` | string[] (URL) | нет | До 8 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 8) |
| `video_urls` | string[] (URL) | нет | До 3 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 15 сек. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее. (до 3) |
| `audio_urls` | string[] (URL) | нет | До 3 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 2 до 15 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 3) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p, 1080p, 4k. (одно из: `480p`, `720p`, `1080p`, `4k`; по умолчанию `720p`) |
| `quality` | string | нет | fast — быстрее и дешевле, quality — детальнее. 1080p и 4K доступны только в quality. (одно из: `fast`, `quality`; по умолчанию `fast`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "quality": "fast",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): Fast 480p, за секунду — 8.95 ₽ ($0.0994); Fast 720p, за секунду — 14.90 ₽ ($0.1656); Quality 480p, за секунду — 13.41 ₽ ($0.1490); Quality 720p, за секунду — 22.36 ₽ ($0.2484); Quality 1080p, за секунду — 59.62 ₽ ($0.6624); Quality 4K, за секунду — 119.23 ₽ ($1.3248); Fast 480p с видео на входе, за секунду ролика — 5.45 ₽ ($0.0606); Fast 480p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 5.45 ₽ ($0.0606); Fast 720p с видео на входе, за секунду ролика — 9.09 ₽ ($0.1010); Fast 720p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 9.09 ₽ ($0.1010); Quality 480p с видео на входе, за секунду ролика — 8.18 ₽ ($0.0909); Quality 480p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 8.18 ₽ ($0.0909); Quality 720p с видео на входе, за секунду ролика — 13.63 ₽ ($0.1515); Quality 720p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 13.63 ₽ ($0.1515); Quality 1080p с видео на входе, за секунду ролика — 36.37 ₽ ($0.4041); Quality 1080p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 36.37 ₽ ($0.4041); Quality 4K с видео на входе, за секунду ролика — 72.73 ₽ ($0.8081); Quality 4K с видео на входе, за секунду видео на входе (не меньше длины ролика) — 72.73 ₽ ($0.8081).


---

## MiniMax H3 (MiniMax)

Сильна в сценах с речью и живой мимикой, в том числе на русском. Снимает в 768p и 2K, оживляет кадр, работает с референсами героя, движения и голоса.

Идентификатор модели: `minimax/h3`. Режимы: `text-to-video`, `image-to-video`, `reference-to-video`.

### MiniMax H3 — Текст → видео

`POST https://api.outsee.io/v1/minimax/h3/text-to-video`

Ролик по описанию до 15 секунд, в том числе в 2K.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 000 символов. (до 7000 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 768p, 2k. (одно из: `768p`, `2k`; по умолчанию `2k`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "2k",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 768p, за секунду ролика — 9.72 ₽ ($0.1080); 2K, за секунду ролика — 19.44 ₽ ($0.2160).

### MiniMax H3 — Фото → видео

`POST https://api.outsee.io/v1/minimax/h3/image-to-video`

Оживляет изображение: по желанию с последним кадром. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 000 символов. (до 7000 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 768p, 2k. (одно из: `768p`, `2k`; по умолчанию `2k`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "2k"
}
```

Цена (за секунду): 768p, за секунду ролика — 9.72 ₽ ($0.1080); 2K, за секунду ролика — 19.44 ₽ ($0.2160).

### MiniMax H3 — Видео по референсам

`POST https://api.outsee.io/v1/minimax/h3/reference-to-video`

Ролик по референсам: до 9 изображений, 3 видео и 3 аудио, всего не больше 12.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «герой с изображения 1». До 7 000 символов. (до 7000 символов) |
| `image_urls` | string[] (URL) | нет | До 9 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 9) |
| `video_urls` | string[] (URL) | нет | До 3 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 15 сек. (до 3) |
| `audio_urls` | string[] (URL) | нет | До 3 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 2 до 15 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 3) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 768p, 2k. (одно из: `768p`, `2k`; по умолчанию `2k`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, auto. auto — формат подбирается по референсам. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`, `auto`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "2k",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): 768p, за секунду ролика — 9.72 ₽ ($0.1080); 2K, за секунду ролика — 19.44 ₽ ($0.2160); 768p, за секунду видео на входе — 9.72 ₽ ($0.1080); 2K, за секунду видео на входе — 19.44 ₽ ($0.2160).


---

## Seedance 2.0 Mini (ByteDance)

Для массовых сценариев, где важны скорость и цена: ролики до 15 секунд в 480p и 720p со звуком, оживление кадра и референсы — те же возможности, что у Seedance 2.0, в облегчённом виде.

Идентификатор модели: `bytedance/seedance-2.0-mini`. Режимы: `text-to-video`, `image-to-video`, `reference-to-video`.

### Seedance 2.0 Mini — Текст → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.0-mini/text-to-video`

Ролик по описанию: до 15 секунд со звуком.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 500 символов. (до 7500 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p. (одно из: `480p`, `720p`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 480p, за секунду — 6.53 ₽ ($0.0725); 720p, за секунду — 13.04 ₽ ($0.1449).

### Seedance 2.0 Mini — Фото → видео

`POST https://api.outsee.io/v1/bytedance/seedance-2.0-mini/image-to-video`

Оживляет изображение: ролик начинается с вашего кадра, по желанию заканчивается вторым.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 7 500 символов. (до 7500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p. (одно из: `480p`, `720p`; по умолчанию `720p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "720p"
}
```

Цена (за секунду): 480p, за секунду — 6.53 ₽ ($0.0725); 720p, за секунду — 13.04 ₽ ($0.1449).

### Seedance 2.0 Mini — Видео по референсам

`POST https://api.outsee.io/v1/bytedance/seedance-2.0-mini/reference-to-video`

Ролик по референсам: до 8 изображений, 3 видео и 3 аудио. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «герой с изображения 1». До 7 500 символов. (до 7500 символов) |
| `image_urls` | string[] (URL) | нет | До 8 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 8) |
| `video_urls` | string[] (URL) | нет | До 3 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 15 сек. С видео на входе действует ставка режима с видео: оплачиваются секунды ролика и секунды входа, вход считается не короче ролика. Итог — примерно на 22% дороже того же ролика без видео, если вход не длиннее ролика, и больше, если длиннее. (до 3) |
| `audio_urls` | string[] (URL) | нет | До 3 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 2 до 15 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 3) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 4 до 15. (4–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 720p. (одно из: `480p`, `720p`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): 480p, за секунду — 6.53 ₽ ($0.0725); 720p, за секунду — 13.04 ₽ ($0.1449); 480p с видео на входе, за секунду ролика — 3.98 ₽ ($0.0442); 480p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 3.98 ₽ ($0.0442); 720p с видео на входе, за секунду ролика — 7.96 ₽ ($0.0884); 720p с видео на входе, за секунду видео на входе (не меньше длины ролика) — 7.96 ₽ ($0.0884).


---

## Kling 3.0 Turbo (Kuaishou)

То же движение Kling 3.0 с ускоренным рендером. Звук встроен всегда, 720p и 1080p, от 3 до 15 секунд, оживление кадра.

Идентификатор модели: `kuaishou/kling-3.0-turbo`. Режимы: `text-to-video`, `image-to-video`.

### Kling 3.0 Turbo — Текст → видео

`POST https://api.outsee.io/v1/kuaishou/kling-3.0-turbo/text-to-video`

Ролик по описанию.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 3 до 15. (3–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p. (одно из: `720p`, `1080p`; по умолчанию `720p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 1:1. (одно из: `16:9`, `9:16`, `1:1`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 720p со звуком, за секунду — 11.66 ₽ ($0.1296); 1080p со звуком, за секунду — 16.04 ₽ ($0.1782).

### Kling 3.0 Turbo — Фото → видео

`POST https://api.outsee.io/v1/kuaishou/kling-3.0-turbo/image-to-video`

Оживляет изображение. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 3 до 15. (3–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p. (одно из: `720p`, `1080p`; по умолчанию `720p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "720p"
}
```

Цена (за секунду): 720p со звуком, за секунду — 11.66 ₽ ($0.1296); 1080p со звуком, за секунду — 16.04 ₽ ($0.1782).


---

## MiniMax H3 Max (MiniMax)

Для сценариев, где важна скорость: превизы, черновики, быстрые итерации. Ролики до 15 секунд со звуком в 480p и 768p, оживление кадра и референсы.

Идентификатор модели: `minimax/h3-max`. Режимы: `text-to-video`, `image-to-video`, `reference-to-video`.

### MiniMax H3 Max — Текст → видео

`POST https://api.outsee.io/v1/minimax/h3-max/text-to-video`

Самый быстрый рендер: ролик по описанию до 15 секунд.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 50 000 символов. (до 50000 символов) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 5 до 15. (5–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 768p. (одно из: `480p`, `768p`; по умолчанию `768p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}
```

Цена (за секунду): 480p, за секунду ролика — 9.72 ₽ ($0.1080); 768p, за секунду ролика — 12.96 ₽ ($0.1440).

### MiniMax H3 Max — Фото → видео

`POST https://api.outsee.io/v1/minimax/h3-max/image-to-video`

Оживляет изображение: по желанию с последним кадром. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 50 000 символов. (до 50000 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 5 до 15. (5–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 768p. (одно из: `480p`, `768p`; по умолчанию `768p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "768p"
}
```

Цена (за секунду): 480p, за секунду ролика — 9.72 ₽ ($0.1080); 768p, за секунду ролика — 12.96 ₽ ($0.1440).

### MiniMax H3 Max — Видео по референсам

`POST https://api.outsee.io/v1/minimax/h3-max/reference-to-video`

Ролик по референсам: до 9 изображений, 3 видео и 3 аудио, всего не больше 12.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика. На референсы ссылайтесь по порядку: «герой с изображения 1». До 50 000 символов. (до 50000 символов) |
| `image_urls` | string[] (URL) | нет | До 9 изображений: герой, товар, одежда, локация. В промпте на них можно ссылаться как «изображение 1», «изображение 2». (до 9) |
| `video_urls` | string[] (URL) | нет | До 3 роликов MP4 или MOV: движение, камера, монтаж. Каждый не короче 2 сек, вместе не длиннее 15 сек. (до 3) |
| `audio_urls` | string[] (URL) | нет | До 3 аудио (MP3, WAV, M4A; AAC, OGG и FLAC перекодируются в MP3) длиной от 2 до 15 сек: голос, музыка, ритм. Передаются вместе хотя бы с одним изображением или видео. (до 3) |
| `duration` | integer | нет | Длительность ролика в секундах, целое число от 5 до 15. (5–15; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 480p, 768p. (одно из: `480p`, `768p`; по умолчанию `768p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. (одно из: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`; по умолчанию `16:9`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/hero.jpg"
  ]
}
```

Цена (за секунду): 480p, за секунду ролика — 9.72 ₽ ($0.1080); 768p, за секунду ролика — 12.96 ₽ ($0.1440); 480p, за секунду видео на входе — 9.72 ₽ ($0.1080); 768p, за секунду видео на входе — 24.30 ₽ ($0.2700).


---

## Kling 2.6 (Kuaishou)

Лучшее соотношение цены и качества среди Kling: плавное реалистичное движение, первый и последний кадр, звук по желанию.

Идентификатор модели: `kuaishou/kling-2.6`. Режимы: `text-to-video`, `image-to-video`.

### Kling 2.6 — Текст → видео

`POST https://api.outsee.io/v1/kuaishou/kling-2.6/text-to-video`

Ролик по описанию.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `duration` | integer | нет | Длительность ролика в секундах: 5, 10. (одно из: `5`, `10`; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p. (одно из: `720p`, `1080p`; по умолчанию `1080p`) |
| `aspect_ratio` | string | нет | Соотношение сторон: 16:9, 9:16, 1:1. (одно из: `16:9`, `9:16`, `1:1`; по умолчанию `16:9`) |
| `generate_audio` | boolean | нет | Сгенерировать звук вместе с роликом. Цена со звуком выше. (по умолчанию `false`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": false
}
```

Цена (за секунду): 720p, за секунду — 3.93 ₽ ($0.0437); 1080p, за секунду — 7.00 ₽ ($0.0778); 720p со звуком, за секунду — 7.88 ₽ ($0.0875); 1080p со звуком, за секунду — 13.99 ₽ ($0.1555).

### Kling 2.6 — Фото → видео

`POST https://api.outsee.io/v1/kuaishou/kling-2.6/image-to-video`

Оживляет изображение: по желанию с последним кадром. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах: 5, 10. (одно из: `5`, `10`; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p. (одно из: `720p`, `1080p`; по умолчанию `1080p`) |
| `generate_audio` | boolean | нет | Сгенерировать звук вместе с роликом. Цена со звуком выше. (по умолчанию `false`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "1080p",
  "generate_audio": false
}
```

Цена (за секунду): 720p, за секунду — 3.93 ₽ ($0.0437); 1080p, за секунду — 7.00 ₽ ($0.0778); 720p со звуком, за секунду — 7.88 ₽ ($0.0875); 1080p со звуком, за секунду — 13.99 ₽ ($0.1555).


---

## Kling 3.0 Motion Control (Kuaishou)

Берёт движение и мимику из ролика-образца и переносит их на персонажа с изображения. Лицо и внешность героя сохраняются. Оплачиваются секунды ролика-образца.

Идентификатор модели: `kuaishou/kling-3.0-motion-control`. Режимы: `motion-transfer`.

### Kling 3.0 Motion Control — Перенос движения

`POST https://api.outsee.io/v1/kuaishou/kling-3.0-motion-control/motion-transfer`

Герой с изображения повторяет движение из видео-образца.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `image_url` | string (URL) | да | Изображение героя, на которого переносится движение. Лучше в полный рост, лицо хорошо видно. |
| `video_url` | string (URL) | да | Ролик-образец с движением: от 3 до 30 сек (до 10 сек при character_orientation: "image"). |
| `character_orientation` | string | нет | video — герой поворачивается как в образце (до 30 сек), image — сохраняет позу и ракурс с изображения (до 10 сек). (одно из: `video`, `image`; по умолчанию `video`) |
| `quality` | string | нет | std — стандартное, pro — детальнее и стабильнее. (одно из: `std`, `pro`; по умолчанию `std`) |
| `prompt` | string | нет | Необязательно. Уточнения к сцене: фон, одежда, настроение. До 2 500 символов. (до 2500 символов) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "image_url": "https://example.com/frame.jpg",
  "video_url": "https://example.com/source.mp4",
  "character_orientation": "video",
  "quality": "std",
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя"
}
```

Цена (за секунду): Standard, за секунду образца — 8.75 ₽ ($0.0972); Pro, за секунду образца — 13.12 ₽ ($0.1458).


---

## Kling 2.5 Turbo (Kuaishou)

Отлично переводит один кадр в другой и оживляет фото. Ролики на 5 и 10 секунд в 720p и 1080p.

Идентификатор модели: `kuaishou/kling-2.5-turbo`. Режимы: `image-to-video`.

### Kling 2.5 Turbo — Фото → видео

`POST https://api.outsee.io/v1/kuaishou/kling-2.5-turbo/image-to-video`

Оживляет изображение: по желанию с последним кадром. Формат берётся из кадра.

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| `prompt` | string | да | Описание ролика: сцена, действие, камера, свет, звук. До 2 500 символов. (до 2500 символов) |
| `image_url` | string (URL) | да | Ссылка на изображение, с которого начнётся ролик. JPEG, PNG или WebP до 20 МБ. |
| `end_image_url` | string (URL) | нет | Необязательно. Ссылка на изображение, которым закончится ролик. |
| `duration` | integer | нет | Длительность ролика в секундах: 5, 10. (одно из: `5`, `10`; по умолчанию `5`) |
| `resolution` | string | нет | Разрешение ролика: 720p, 1080p. (одно из: `720p`, `1080p`; по умолчанию `1080p`) |
| `webhook_url` | string (URL) | нет | Адрес https://, куда придёт уведомление о завершении. |

Пример тела запроса:

```json
{
  "prompt": "Кинематографичный проезд камеры вдоль побережья на закате, мягкий тёплый свет, шум прибоя",
  "image_url": "https://example.com/frame.jpg",
  "duration": 5,
  "resolution": "1080p"
}
```

Цена (за секунду): 720p, за секунду — 3.50 ₽ ($0.0389); 1080p, за секунду — 7.00 ₽ ($0.0778).