Обзор 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-статусы, коды ошибок

На этой странице