Developer docs

Aisha API документация

Reference-страницы TTS и STT из system frontend перенесены в landing. Теперь developer docs работают здесь и оформлены в стилистике landing UI.

API ключи Связаться с командой

Base URL: https://back.aisha.group

API v1 TTS Sync / Async

TTS API

Endpoints для Text-to-Speech. Для server-to-server интеграции отправляйте X-Api-Key в каждом запросе.

Для генерации аудио отправьте transcript на POST /api/v1/tts/post/.

Если передать webhook_notification_url, запрос будет обработан async и вернет 202 Accepted.

Проверяйте результат через GET /api/v1/tts/status/{id}/ или history.

Endpoints

POST

Создать аудио

/api/v1/tts/post/

GET

Проверить статус

/api/v1/tts/status/{id}/

GET

История

/api/v1/tts/get/?page=1&limit=10

Открыть reference ↗

API v1 API v2 STT

STT API

Endpoints для Speech-to-Text. Для server-to-server интеграции отправляйте X-Api-Key в каждом запросе.

POST /api/v1/stt/post/ для коротких аудио (sync).

POST /api/v2/stt/post/ для длинных аудио (async, возвращает task_id).

Endpoints

POST

Транскрипция короткого аудио

/api/v1/stt/post/

GET

v1 history список

/api/v1/stt/get/?page=1&limit=10

POST

Длинное аудио (async)

/api/v2/stt/post/

GET

v2 history список

/api/v2/stt/get/

Открыть reference ↗

Быстрый старт

Для разработчиков

Для server-to-server интеграции используйте `X-Api-Key`. Для больших файлов и async задач сразу реализуйте history и status endpoints.

1. Получите API key

Создайте API key в Space и передавайте его в каждом запросе через header `X-Api-Key`.

2. Отправьте тестовый запрос

Проверьте TTS/STT endpoints через cURL или backend-код и убедитесь в нужном формате response.

3. Подключите status и history

Для async-потоков используйте `status` и `history`, чтобы закрыть полный workflow.