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

# Введение

> API для получения транскриптов и саммари из аудио и видео файлов

<Note>
  Эта документация описывает SynopsisAI API для автоматического создания
  транскриптов и саммари из аудио и видео файлов с помощью искусственного интеллекта.
</Note>

## Добро пожаловать

SynopsisAI API позволяет вам легко интегрировать возможности создания транскриптов и саммари в ваши приложения. API принимает прямые ссылки на аудио или видео файлы и возвращает структурированные результаты обработки.

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

Все API эндпоинты требуют аутентификации с помощью API ключа в заголовке запроса.

API ключ должен быть передан в заголовке `Authorization` каждого запроса:

```bash theme={null}
curl --request POST \
  --url https://stiltedly-viable-akita.cloudpub.ru/api/v1/prediction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
```

## Основные возможности

### 🎯 Создание Синопсиса

Отправьте прямую ссылку на аудио или видео файл для создания транскрипта и/или саммари.

### 📊 Получение результатов

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

### 💳 Управление балансом

Проверяйте текущий баланс и получайте детальную статистику потребления кредитов за любой период.

### ⚙️ Гибкие настройки

* Выбор языка входного контента
* Настройка языка результата
* Количество пунктов в саммари
* Использование готовых шаблонов или своих промптов
* Webhook уведомления о готовности

## Эндпоинты API

### Обработка контента

* **POST /v1/prediction** - Запустить обработку медиафайла
* **GET /v1/prediction/{taskId}** - Получить статус задачи по ID
* **POST /v1/summarization** - Запустить только саммаризацию текста
* **POST /v1/depersonalization** - Запустить только деперсонализацию текста

## Поддерживаемые форматы

API поддерживает различные форматы аудио и видео файлов. Файлы должны быть доступны по прямой ссылке (например, из облачного s3 хранилища). Ссылки на медиатеки (Rutube, Youtube и подобные), или облачные диски (Google Drive, Yandex disk и подобные) не поддерживаются

## Базовый URL

```
https://stiltedly-viable-akita.cloudpub.ru/api
```