> ## 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.

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

> Генерация, reference-to-video и редактирование видео с HappyHorse 1.1

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

* Публичное имя модели: `happyhorse-1.1`
* Используйте `action` для выбора text-to-video, image-to-video, reference-to-video или video editing
* Если `action` не указан, запрос с first-frame изображением считается image-to-video, иначе text-to-video
* Асинхронное управление задачами через стандартный эндпоинт статуса video task

## Авторизация

**Authorization** `string` *required*

Все запросы требуют Bearer Token.

```
Authorization: Bearer YOUR_API_KEY
```

## Тело запроса

**model** `string` *required* (default: happyhorse-1.1)

Название модели генерации видео. Фиксированное значение: `happyhorse-1.1`.

**action** `string` (default: text-to-video)

Режим генерации.

Варианты:

* `text-to-video`
* `image-to-video`
* `reference-to-video`
* `video-edit`

**prompt** `string`

Текстовое описание видео. Обязательно для text-to-video, reference-to-video и video-edit.

**image\_urls** `string[]`

URL first-frame изображения для image-to-video. Используется только первое изображение.

Также принимаются совместимые поля: `input_reference`, `images`, `image` или `image_with_roles[{ role: "first_frame" }]`.

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

URL reference изображений. Для `reference-to-video` требуется от `1` до `9` изображений; для `video-edit` можно передать до `5`.

**url** `string`

URL входного видео для редактирования. Обязательно при `action=video-edit`.

**audio\_setting** `string` (default: auto)

Управление аудио для video-edit: `auto` или `origin`.

**duration** `integer` (default: 5)

Длительность видео в секундах. Диапазон: `3`–`15`.

**resolution** `string` (default: 1080P)

Разрешение видео: `720P` или `1080P`.

**aspect\_ratio** `string` (default: 16:9)

Соотношение сторон для text-to-video: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`.

**seed** `integer`

Random seed для воспроизводимой генерации.

**watermark** `boolean` (default: true)

Добавлять ли watermark.

```bash cURL 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": "happyhorse-1.1",
    "action": "text-to-video",
    "prompt": "A cinematic city scene at night",
    "duration": 10,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'
```

## Проверка задачи

Эндпоинт создания возвращает task ID. Используйте стандартный video task status endpoint для получения результата:

```bash theme={null}
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"
```


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