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

# Генерация видео

> Создаёт задачу генерации и возвращает `task_id`.
Режим определяется автоматически по промпту и переданным материалам.
Параметры проверяются после создания задачи: ошибка проверки возвращается
через `/v1/videos/fetch` со статусом `rejected`.
Ошибки авторизации, неизвестной модели и доступа по группе ключа
возвращаются сразу с HTTP-кодом ошибки, без создания задачи.


Создаёт задачу генерации видео и возвращает её `task_id`.

### Заголовки

| Заголовок | Значение |
| - | - |
| `Authorization` | `Bearer <ваш API-ключ>` |
| `Content-Type` | `application/json` |

### Режимы генерации

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

* **Текст → видео** — только `prompt`.
* **Генерация по референсам** — `prompt` вместе с `images`, `videos` и/или `audios`. Модель переносит в видео персонажей, предметы, окружение, движение и голос из референсов.
* **Редактирование видео** — `prompt` с описанием правки и исходное видео в `videos`.
* **Продолжение видео** — `prompt` с описанием того, что происходит дальше, и исходное видео в `videos`.

В промпте можно ссылаться на материалы по их порядку в списке: «персонаж с изображения 1 садится на стул с изображения 2», «человек из видео 1 говорит…». Нумерация в каждом поле своя и начинается с 1.

### Ограничения

* `duration` — целое число от 2 до 30 секунд.
* `images` — не более 10 изображений.
* `videos` — не более 5 видео общей длительностью не более 15 секунд.
* `audios` — не более 5 аудиофайлов общей длительностью не более 15 секунд.
* Суммарная длительность входных видео и `duration` — **не более 30 секунд**. Например, с входным видео на 12 секунд можно запросить не больше 18 секунд результата.
* В `videos` должны быть именно видеофайлы: аудиофайл без видеодорожки будет отклонён.
* Все URL должны быть публично доступны без авторизации.

### Ответ

```json theme={null}
{
  "task_id": "b22c9ae2-0b55-4398-88df-0191aae664f0"
}
```

Задача создаётся сразу, а параметры проверяются уже в процессе её выполнения. Если запрос не прошёл проверку, задача завершится со статусом `rejected` и описанием причины (см. [Ошибки](/docs/wan3/fetch#ошибки)). Ошибки авторизации, неизвестной модели и отсутствия доступа по группе ключа возвращаются сразу с HTTP-кодом ошибки; задача в этом случае не создаётся.

### Примеры

#### Текст → видео

```bash theme={null}
curl https://api.nixai.ru/v1/videos/generations \
  -H "Authorization: Bearer $NIXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3",
    "prompt": "Котёнок бежит по крыше под луной, вдали мерцают неоновые огни города, кинематографичная съёмка, плавное движение камеры",
    "duration": 5,
    "size": "720p",
    "aspect_ratio": "16:9"
  }'
```

#### Генерация по референсам

```bash theme={null}
curl https://api.nixai.ru/v1/videos/generations \
  -H "Authorization: Bearer $NIXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3",
    "prompt": "Человек из видео 1 держит гитару с изображения 2, садится на стул с изображения 3 и играет спокойную мелодию. Девушка с изображения 1 проходит мимо и говорит: «Как красиво, сыграй ещё раз».",
    "images": [
      "https://example.com/girl.jpg",
      "https://example.com/guitar.png",
      "https://example.com/chair.png"
    ],
    "videos": ["https://example.com/man.mp4"],
    "duration": 10,
    "size": "720p"
  }'
```

#### Редактирование видео

```bash theme={null}
curl https://api.nixai.ru/v1/videos/generations \
  -H "Authorization: Bearer $NIXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3",
    "prompt": "Преобразуй всё видео в стиль пластилиновой анимации",
    "videos": ["https://example.com/source.mp4"],
    "duration": 5,
    "size": "720p"
  }'
```

#### Продолжение видео

```bash theme={null}
curl https://api.nixai.ru/v1/videos/generations \
  -H "Authorization: Bearer $NIXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3",
    "prompt": "Продолжи видео: пекарь ставит смазанный хлеб на стол, откладывает кисточку и несёт противень к печи позади, камера следует за ним",
    "videos": ["https://example.com/baker.mp4"],
    "duration": 8,
    "size": "720p"
  }'
```


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://nixai.ru/docs/llms.txt).


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