Обзор API
Введение в Aiesa Platform API — что умеет, как устроен, базовые понятия
Добро пожаловать в Aiesa Platform API. Это документация о том, как ваше приложение может пользоваться нашим сервисом: распознавать речь, генерировать тексты, получать эмбеддинги, а также следить за статусами задач и расходами.
Здесь нет «внутренней кухни» — только то, что нужно, чтобы интегрироваться.
Всё просто: вы получаете API-ключ, отправляете запросы с HTTP-заголовком
Authorization: Bearer <ключ>, а мы возвращаем понятные JSON-ответы.
С чего начать
- Хотите как можно быстрее написать код? → переходите к Быстрому старту, там примеры интеграции на 8 языках.
- Хотите понять всё по порядку? → читайте страницы вниз по списку.
Базовый адрес
Все запросы отправляются на:
https://api.aiesa.ru/v3Что можно делать с API
| Возможность | Страница |
|---|---|
| Транскрипция по файлу или ссылке (пакетно) | Транскрипции |
| Расшифровка в реальном времени (поток) | Транскрипции |
| Генерация текста, следование сценарию | Chat Completions |
| Эмбеддинги для поиска и RAG | Эмбеддинги |
| Публичный расчёт стоимости | Стоимость |
Управление аккаунтом, ключами и вебхуками выполняется в вашем кабинете (внутренние сервисы) — напрямую через публичный API недоступно.
Идентификаторы
API использует UUID (550e8400-e29b-41d4-a716-446655440000) везде, где нужен
идентификатор: transcription_id, session_id, task_id и т.д.
Форматы запросов
- Текстовые запросы:
application/json. - Транскрипция:
application/json(по ссылкеurl) илиmultipart/form-data(загрузка файлаfileили передачаurl). - Ответы: всегда
application/json(кроме потокового чата — тамtext/event-stream).
Содержание
| Страница | О чём |
|---|---|
| Быстрый старт | Первый запрос, примеры интеграции на Bash, Python, Go, Rust, PHP, C++, JavaScript, Java |
| Аутентификация | API-ключи, правила безопасности, ошибки авторизации |
| Формат ответов и ошибок | Структура успешных ответов, объект ошибки, категории |
| Лимиты | Ограничения на запросы, файлы, длительность |
| Стоимость | Расчёт цены, как происходит списание |
| Транскрипции | Синхронная, асинхронная и потоковая транскрипция |
| Chat Completions | Генерация текста, обычный и потоковый ответ |
| Эмбеддинги | Векторные представления текста |
| Модели | Доступные модели |
| Вебхуки | Уведомления о событиях, проверка подписи |
| Справочник | Все эндпоинты, HTTP-статусы, коды ошибок |