### GET /pay/

Source: https://veo.tpekollec.ru/openapi.json

Получение списка платежей

```markdown
### Parameters

- **chat_id** (union, query, optional): Фильтр по chat_id
- **limit** (integer, query, optional): Количество записей
- **offset** (integer, query, optional): Смещение
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**PaymentListResponse**
- **payments** (array (PaymentResponse)) (required)
  Array items:
    - **id** (string) (required)
    - **payment_id** (string) (required)
    - **chat_id** (string) (required)
    - **payload** (string) (required)
    - **amount** (integer) (required)
    - **currency** (string) (required)
    - **coins** (integer) (required)
    - **created_at** (string) (required)
- **total** (integer) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pay/?chat_id=value&limit=100&offset=0"
```

```

--------------------------------

### GET /webapp/models

Source: https://veo.tpekollec.ru/openapi.json

Возвращает список моделей генерации видео.
- type=text2video: модели для генерации по тексту
- type=img2video: модели для генерации по фото

```markdown
### Parameters

- **type** (string (text2video|img2video), query, optional)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

- Array of VideoModelOut

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/webapp/models?type=text2video"
```

```

--------------------------------

### GET /admin/characters/

Source: https://veo.tpekollec.ru/openapi.json

Получение списка всех персонажей

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**CharacterListResponse**
- **characters** (array (CharacterResponse)) (required)
  Array items:
    - **id** (string) (required)
    - **name** (string) (required)
    - **prompts** (array (string)) (required)
    - **steps_gen** (integer) (required)
    - **frame_url** (string)
    - **created_at** (string) (required)
    - **updated_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/admin/characters/"
```

```

--------------------------------

### GET /users/all

Source: https://veo.tpekollec.ru/openapi.json

Получение всех пользователей.

Cтатус запроса:
- 200 OK - успешное получение всех пользователей
- 404 Not Found - ошибка при получении всех пользователей
- 500 Internal Server Error - ошибка при получении всех пользователей

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

- Array of UserSchema

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/users/all"
```

```

--------------------------------

### GET /partner/all

Source: https://veo.tpekollec.ru/openapi.json

Получение всех партнерских ссылок.

Cтатус запроса:
- 200 OK - успешное получение
- 422 Unprocessable Entity - ошибка валидации входных данных

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/partner/all"
```

```

--------------------------------

### GET /tasks/

Source: https://veo.tpekollec.ru/openapi.json

Получить все задачи.

Cтатус запроса:
- 200 OK - список задач успешно получен
- 500 Internal Server Error - ошибка сервера

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Возвращаемые данные:
- Список объектов задачи (TaskRead)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

- Array of TaskRead

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/tasks/"
```

```

--------------------------------

### GET /tasks/{task_id}

Source: https://veo.tpekollec.ru/openapi.json

Получить задачу по task_id.

Cтатус запроса:
- 200 OK - задача найдена и возвращена
- 404 Not Found - задача не найдена
- 500 Internal Server Error - ошибка сервера

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Параметры пути:
- `task_id: str` - уникальный идентификатор задачи

```markdown
### Parameters

- **task_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**TaskRead**
- **id** (string (uuid)) (required)
- **task_id** (string) (required)
- **chat_id** (string) (required)
- **raw** (string)
- **is_video** (boolean) (required)
- **rating** (integer)
- **created_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/tasks/{task_id}"
```

```

--------------------------------

### GET /pay/{payment_id}

Source: https://veo.tpekollec.ru/openapi.json

Получение платежа по ID

```markdown
### Parameters

- **payment_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**PaymentResponse**
- **id** (string) (required)
- **payment_id** (string) (required)
- **chat_id** (string) (required)
- **payload** (string) (required)
- **amount** (integer) (required)
- **currency** (string) (required)
- **coins** (integer) (required)
- **created_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pay/{payment_id}"
```

```

--------------------------------

### GET /pay/user/{chat_id}

Source: https://veo.tpekollec.ru/openapi.json

Получение списка платежей конкретного пользователя

```markdown
### Parameters

- **chat_id** (string, path, required)
- **limit** (integer, query, optional): Количество записей
- **offset** (integer, query, optional): Смещение
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**PaymentListResponse**
- **payments** (array (PaymentResponse)) (required)
  Array items:
    - **id** (string) (required)
    - **payment_id** (string) (required)
    - **chat_id** (string) (required)
    - **payload** (string) (required)
    - **amount** (integer) (required)
    - **currency** (string) (required)
    - **coins** (integer) (required)
    - **created_at** (string) (required)
- **total** (integer) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pay/user/{chat_id}?limit=100&offset=0"
```

```

--------------------------------

### GET /tasks/get-chat/{task_id}/

Source: https://veo.tpekollec.ru/openapi.json

API endpoint for GET /tasks/get-chat/{task_id}/

```markdown
### Parameters

- **task_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/tasks/get-chat/{task_id}/"
```

```

--------------------------------

### GET /webapp/generations/{chat_id}

Source: https://veo.tpekollec.ru/openapi.json

Получение списка генераций (видео и фото) пользователя по chat_id.

Используется веб-приложением для отображения истории генераций пользователя.

Cтатус запроса:
- 200 OK - успешное получение списка генераций
- 400 Bad Request - ошибка валидации
- 500 Internal Server Error - внутренняя ошибка сервера

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя
- `limit: int | None` - максимальное количество записей (по умолчанию 20)

Выходные данные:
- `ok: bool` - статус успешности
- `videos: list[VideoGenerationOut]` - список генераций видео
- `photos: list[PhotoGenerationOut]` - список генераций фото

```markdown
### Parameters

- **chat_id** (string, path, required)
- **limit** (union, query, optional)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**GenerationsListOut**
- **ok** (boolean) (required)
- **videos** (array (VideoGenerationOut)) (required)
  Array items:
    - **id** (string) (required)
    - **owner** (string) (required)
    - **model** (string) (required)
    - **task_id** (string) (required)
    - **gen_type** (string) (required)
    - **image** (object)
    - **placeholder_url** (string)
    - **result_url** (string)
    - **visibility** (string)
    - **status** (string) (required)
    - **error_reason** (string)
    - **created_at** (string) (required)
    - **updated_at** (string) (required)
- **photos** (array (PhotoGenerationOut)) (required)
  Array items:
    - **id** (string) (required)
    - **owner** (string) (required)
    - **task_id** (string) (required)
    - **model** (string) (required)
    - **uploaded_img** (string)
    - **result_url** (string)
    - **prompt** (string) (required)
    - **visibility** (string)
    - **status** (string) (required)
    - **error_reason** (string)
    - **created_at** (string) (required)
    - **updated_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/webapp/generations/{chat_id}?limit=20"
```

```

--------------------------------

### GET /admin/characters/{character_id}

Source: https://veo.tpekollec.ru/openapi.json

Получение персонажа по ID

```markdown
### Parameters

- **character_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response

**CharacterResponse**
- **id** (string) (required)
- **name** (string) (required)
- **prompts** (array (string)) (required)
- **steps_gen** (integer) (required)
- **frame_url** (string)
- **created_at** (string) (required)
- **updated_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/admin/characters/{character_id}"
```

```

--------------------------------

### GET /users/{chat_id}

Source: https://veo.tpekollec.ru/openapi.json

Получение информации о пользователе по chat_id.

Cтатус запроса:
- 200 OK - успешное получение информации
- 404 Not Found - пользователь с таким chat_id не найден

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя в Telegram

Выходные данные:
- `id: int` - внутренний идентификатор пользователя в базе данных
- `nickname: str` | None - имя пользователя в Telegram
- `chat_id: str` - уникальный идентификатор пользователя в Telegram
- `coins: int` - количество монет у пользователя

```markdown
### Parameters

- **chat_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/users/{chat_id}"
```

```

--------------------------------

### GET /users/{chat_id}/coins

Source: https://veo.tpekollec.ru/openapi.json

Получение количества монет пользователя по chat_id.

Cтатус запроса:
- 200 OK - успешное получение количества монет
- 404 Not Found - пользователь с таким chat_id не найден

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя в Telegram

Выходные данные:
- `ok: bool` - статус успешности запроса
- `coins: int` - количество монет у пользователя

```markdown
### Parameters

- **chat_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/users/{chat_id}/coins"
```

```

--------------------------------

### GET /users/{chat_id}/ref_code

Source: https://veo.tpekollec.ru/openapi.json

Получение реферального кода пользователя по chat_id.

Cтатус запроса:
- 200 OK - успешное получение реферального кода
- 404 Not Found - пользователь с таким chat_id не найден

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя в Telegram

Выходные данные:
- `ok: bool` - статус успешности запроса
- `ref_code: str` | None - реферальный код пользователя, если он есть

```markdown
### Parameters

- **chat_id** (string, path, required)
- **x-api-key** (union, header, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/users/{chat_id}/ref_code"
```

```

--------------------------------

### POST /webapp/prompt/suggest

Source: https://veo.tpekollec.ru/openapi.json

Генерирует промпт для видео (text2video / img2video) с использованием PromptAI.
Логика повторяет /prompt/suggest, но предназначена для веб-приложения.

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **chat_id** (string) (required)
- **brief** (string) (required)
- **clarifications** (array (string))
- **attempt** (integer)
- **previous_prompt** (string)
- **image_url** (string)

### Responses

#### 200 - Successful Response

**WebappPromptResponse**
- **prompt_ru** (string) (required)
- **prompt_en** (string) (required)
- **icon** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/webapp/prompt/suggest" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": "string",
  "brief": "string",
  "clarifications": "value",
  "attempt": "1",
  "previous_prompt": "value",
  "image_url": "value"
}'
```

```

--------------------------------

### POST /pay/sbp/create

Source: https://veo.tpekollec.ru/openapi.json

API endpoint for POST /pay/sbp/create

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **amount** (string) (required)
- **desc** (string) (required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/pay/sbp/create" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": "string",
  "desc": "string"
}'
```

```

--------------------------------

### PATCH /prompt/change_system_prompt

Source: https://veo.tpekollec.ru/openapi.json

Изменение системного промпта для генерации.

Статус запроса:
- 200 OK - успешное изменение промпта
- 500 Internal Server Error - ошибка сервера

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `system_prompt: str` - новый системный промпт для генерации

Выходные данные:
- `message: str` - сообщение об успешном изменении промпта

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **system_prompt** (string) (required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X PATCH "https://api.example.com/prompt/change_system_prompt" \
  -H "Content-Type: application/json" \
  -d '{
  "system_prompt": "string"
}'
```

```

--------------------------------

### POST /partner/create

Source: https://veo.tpekollec.ru/openapi.json

Создание партнерской ссылки для пользователя.

Cтатус запроса:
- 200 OK - успешное создание
- 400 Bad Request - ошибка бизнес-логики (например, пользователь не найден)
- 422 Unprocessable Entity - ошибка валидации входных данных

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **user_chat_id** (string) (required)
- **percentage** (integer) (required)
- **active** (boolean)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/partner/create" \
  -H "Content-Type: application/json" \
  -d '{
  "user_chat_id": "string",
  "percentage": "0",
  "active": "true"
}'
```

```

--------------------------------

### POST /admin/characters/

Source: https://veo.tpekollec.ru/openapi.json

Создание нового персонажа

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **name** (string) (required): Имя персонажа
- **prompts** (array (string)) (required): Список промптов для генерации

### Responses

#### 201 - Successful Response

**CharacterResponse**
- **id** (string) (required)
- **name** (string) (required)
- **prompts** (array (string)) (required)
- **steps_gen** (integer) (required)
- **frame_url** (string)
- **created_at** (string) (required)
- **updated_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/admin/characters/" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "prompts": [
    "string"
  ]
}'
```

```

--------------------------------

### POST /webapp/generate/image

Source: https://veo.tpekollec.ru/openapi.json

Генерация изображения по текстовому описанию с помощью KIE (nano-banana-pro).

Используется веб-приложением для создания изображений по текстовому промпту.

Cтатус запроса:
- 200 OK - успешная генерация задачи
- 400 Bad Request - ошибка валидации входных данных или бизнес-логики
- 502 Bad Gateway - ошибка связи с KIE

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя
- `prompt: str` - текстовое описание для генерации изображения
- `aspect_ratio: str` - соотношение сторон ("1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9", "auto")
- `resolution: str` - разрешение изображения ("1K", "2K", "4K")
- `output_format: str` - формат выходного файла ("png", "jpg")

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **chat_id** (string) (required)
- **prompt** (string) (required)
- **aspect_ratio** (string (1:1|2:3|3:2|3:4|4:3|4:5|5:4|9:16|16:9|21:9|auto)) (required) ("1:1"|"2:3"|"3:2"|"3:4"|"4:3"|"4:5"|"5:4"|"9:16"|"16:9"|"21:9"|"auto")
- **resolution** (string (1K|2K|4K)) (required) ("1K"|"2K"|"4K")
- **output_format** (string (png|jpg)) (required) ("png"|"jpg")

### Responses

#### 200 - Successful Response

**GenerateOut**
- **ok** (boolean) (required)
- **task_id** (string) (required)
- **input_image_url** (string)
- **raw** (object)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/webapp/generate/image" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": "string",
  "prompt": "string",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "png"
}'
```

```

--------------------------------

### Schema: PartnerCreate

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for PartnerCreate

```markdown
## Schema: PartnerCreate

Schema definition for PartnerCreate

**Type:** object

- **user_chat_id** (string) (required)
- **percentage** (integer) (required)
- **active** (boolean)

```

--------------------------------

### API Overview: Документация для ObjectiVEO 3

Source: https://veo.tpekollec.ru/openapi.json

Сервис для автоматической генерации коротких видео по текстовым описаниям и фотографиям с использованием нейросетей. Предоставляет HTTP API и интеграцию с Telegram-ботом: создание и управление задачами генерации, формирование промптов, отслеживание статуса и уведомления пользователям. Включает публичные и защищённые маршруты. Для защищённых эндпойнтов требуется авторизация; поддерживаются асинхронные задачи и механизмы rate-limiting.

```yaml
# Документация для ObjectiVEO 3
# Version: 1.0:08.25.31:beta

Сервис для автоматической генерации коротких видео по текстовым описаниям и фотографиям с использованием нейросетей. Предоставляет HTTP API и интеграцию с Telegram-ботом: создание и управление задачами генерации, формирование промптов, отслеживание статуса и уведомления пользователям. Включает публичные и защищённые маршруты. Для защищённых эндпойнтов требуется авторизация; поддерживаются асинхронные задачи и механизмы rate-limiting.

# Base URL: Not specified
```

--------------------------------

### Schema: TaskCreate

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for TaskCreate

```markdown
## Schema: TaskCreate

Schema definition for TaskCreate

**Type:** object

- **task_id** (string) (required)
- **chat_id** (string) (required)
- **raw** (string) (required)
- **is_video** (boolean)
- **rating** (integer)
- **created_at** (string)

```

--------------------------------

### POST /prompt/suggest

Source: https://veo.tpekollec.ru/openapi.json

Генерация промпта на основе краткого описания.

Cтатус запроса:
- 200 OK - успешная генерация промпта
- 500 Internal Server Error - ошибка сервера

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя в Telegram
- `brief: str` - краткое описание желаемого изображения
- `clarifications: str | None` - уточнения к описанию
- `attempt: int` - номер попытки (начинается с 1)
- `previous_prompt: str | None` - предыдущий сгенерированный промпт
- `image_url: str | None` - URL изображения для контекстуальной генерации

Выходные данные:
- `prompt: List[str]` - список сгенерированных промптов (на русском и английском языках)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **chat_id** (string) (required)
- **brief** (string)
- **clarifications** (array (string))
- **attempt** (integer)
- **previous_prompt** (string)
- **image_url** (string)

### Responses

#### 200 - Successful Response

**PromptResponse**
- **prompt** (array (string)) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/prompt/suggest" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": "string",
  "brief": "value",
  "clarifications": "value",
  "attempt": "1",
  "previous_prompt": "value",
  "image_url": "value"
}'
```

```

--------------------------------

### Schema: WebappPromptResponse

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for WebappPromptResponse

```markdown
## Schema: WebappPromptResponse

Schema definition for WebappPromptResponse

**Type:** object

- **prompt_ru** (string) (required)
- **prompt_en** (string) (required)
- **icon** (string)

```

--------------------------------

### POST /pay/

Source: https://veo.tpekollec.ru/openapi.json

Создание нового платежа (внутренний эндпоинт)

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **payment_id** (string) (required): ID платежа из Telegram
- **chat_id** (string) (required): ID чата пользователя
- **payload** (string) (required): Payload инвойса
- **amount** (integer) (required): Сумма в минимальных единицах
- **currency** (string) (required): Валюта (RUB, XTR)
- **coins** (integer) (required): Количество начисленных монет

### Responses

#### 201 - Successful Response

**PaymentResponse**
- **id** (string) (required)
- **payment_id** (string) (required)
- **chat_id** (string) (required)
- **payload** (string) (required)
- **amount** (integer) (required)
- **currency** (string) (required)
- **coins** (integer) (required)
- **created_at** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/pay/" \
  -H "Content-Type: application/json" \
  -d '{
  "payment_id": "string",
  "chat_id": "string",
  "payload": "string",
  "amount": "0",
  "currency": "string",
  "coins": "0"
}'
```

```

--------------------------------

### Schema: PromptResponse

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for PromptResponse

```markdown
## Schema: PromptResponse

Schema definition for PromptResponse

**Type:** object

- **prompt** (array (string)) (required)

```

--------------------------------

### Schema: PromptRequest

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for PromptRequest

```markdown
## Schema: PromptRequest

Schema definition for PromptRequest

**Type:** object

- **chat_id** (string) (required)
- **brief** (string)
- **clarifications** (array (string))
- **attempt** (integer)
- **previous_prompt** (string)
- **image_url** (string)

```

--------------------------------

### Schema: CharacterCreate

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for CharacterCreate

```markdown
## Schema: CharacterCreate

Schema definition for CharacterCreate

**Type:** object

- **name** (string) (required): Имя персонажа
- **prompts** (array (string)) (required): Список промптов для генерации

```

--------------------------------

### Schema: WebappPromptRequest

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for WebappPromptRequest

```markdown
## Schema: WebappPromptRequest

Schema definition for WebappPromptRequest

**Type:** object

- **chat_id** (string) (required)
- **brief** (string) (required)
- **clarifications** (array (string))
- **attempt** (integer)
- **previous_prompt** (string)
- **image_url** (string)

```

--------------------------------

### POST /webapp/generate/text

Source: https://veo.tpekollec.ru/openapi.json

Генерация видео по текстовому описанию с помощью KIE (Veo 3).

Используется веб-приложением для создания видео по текстовому промпту.

Cтатус запроса:
- 200 OK - успешная генерация задачи
- 400 Bad Request - ошибка валидации входных данных или бизнес-логики
- 502 Bad Gateway - ошибка связи с KIE (Veo 3)

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя
- `prompt: str` - текстовое описание для генерации видео
- `aspect_ratio: str` - соотношение сторон видео ("16:9", "9:16")
- `model: str` - модель генерации ("sora-2-txt2vid", "sora-2-pro-txt2vid", "veo-3-fast")

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **chat_id** (string) (required)
- **prompt** (string) (required)
- **aspect_ratio** (string) (required)
- **model** (string (sora-2-txt2vid|sora-2-pro-txt2vid|veo-3-fast)) (required) ("sora-2-txt2vid"|"sora-2-pro-txt2vid"|"veo-3-fast")

### Responses

#### 200 - Successful Response

**GenerateOut**
- **ok** (boolean) (required)
- **task_id** (string) (required)
- **input_image_url** (string)
- **raw** (object)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/webapp/generate/text" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": "string",
  "prompt": "string",
  "aspect_ratio": "string",
  "model": "sora-2-txt2vid"
}'
```

```

--------------------------------

### Schema: PaymentCreate

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for PaymentCreate

```markdown
## Schema: PaymentCreate

Schema definition for PaymentCreate

**Type:** object

- **payment_id** (string) (required): ID платежа из Telegram
- **chat_id** (string) (required): ID чата пользователя
- **payload** (string) (required): Payload инвойса
- **amount** (integer) (required): Сумма в минимальных единицах
- **currency** (string) (required): Валюта (RUB, XTR)
- **coins** (integer) (required): Количество начисленных монет

```

--------------------------------

### Schema: UserSchema

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for UserSchema

```markdown
## Schema: UserSchema

Schema definition for UserSchema

**Type:** object

- **id** (string (uuid)) (required)
- **nickname** (string) (required)
- **chat_id** (string) (required)
- **coins** (integer) (required)
- **role** (string (user|partner)) (required) ("user"|"partner")
- **ref_code** (string)
- **referred_by** (string)
- **first_time** (boolean) (required)
- **balance** (number) (required)
- **verified** (boolean) (required)

```

--------------------------------

### Schema: VideoModelOut

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for VideoModelOut

```markdown
## Schema: VideoModelOut

Schema definition for VideoModelOut

**Type:** object

- **id** (string) (required)
- **name** (string) (required)
- **description** (string) (required)
- **internal_model** (string) (required)
- **type** (string (text2video|img2video)) (required) ("text2video"|"img2video")
- **icon** (string) (required)

```

--------------------------------

### POST /users/coins/minus

Source: https://veo.tpekollec.ru/openapi.json

Списание одной монеты у пользователя по chat_id.

Статус запроса:
- 200 OK - успешное списание монеты
- 404 Not Found - пользователь с таким chat_id не найден
- 400 Bad Request - недостаточно монет для списания

> [!important]
> Заголовки запроса:
> - `X-API-KEY: str` - API ключ для аутентификации (обязательный)

Входные данные:
- `chat_id: str` - уникальный идентификатор пользователя в Telegram

Выходные данные:
- `ok: bool` - статус успешности запроса
- `coins: int` - текущее количество монет у пользователя после списания

```markdown
### Parameters

- **x-api-key** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **chat_id** (string) (required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/users/coins/minus" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": "string"
}'
```

```

--------------------------------

### Schema: ChangeSystemPromptRequest

Source: https://veo.tpekollec.ru/openapi.json

Schema definition for ChangeSystemPromptRequest

```markdown
## Schema: ChangeSystemPromptRequest

Schema definition for ChangeSystemPromptRequest

**Type:** object

- **system_prompt** (string) (required)

```