Aisha AI
by voicelab

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

REST API для узбекской речи - синтез речи (text-to-speech), распознавание (speech-to-text) и голосовые агенты. Аутентифицируйтесь по API-ключу и сделайте первый запрос за пару минут.

Получить API key Связаться с командой Base URL https://back.aisha.group

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

Быстрый старт с cURL #

HTTP API

Задайте AISHA_API_KEY в окружении сервера и отправьте запрос напрямую с сервера. Не помещайте ключ в код браузера.

Запрос cURL для TTS

curl --request POST \
  --url https://back.aisha.group/api/v1/tts/post/ \
  --header "X-Api-Key: $AISHA_API_KEY" \
  --header 'Accept-Language: uz' \
  --form 'transcript=Assalomu alaykum, bu AIsha TTS sinovi.' \
  --form 'language=uz' \
  --form 'model=Gulnoza' \
  --form 'mood=Neutral' \
  --form 'speed=1.0'
llms-api.txt

TTS API #

API v1 TTS Sync / Async Realtime

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.
  • Используйте wss://back.aisha.group/api/v1/tts/realtime для realtime TTS через WebSocket или back.aisha.group:443 через gRPC.
  • Отправляйте несколько text turn через одно постоянное соединение и не подключайтесь заново для каждого turn.
  • Тарификация TTS идёт по символам после проверки баланса при начале stream.

Endpoints

  • POST /api/v1/tts/post/ Создать аудио
  • GET /api/v1/tts/status/{id}/ Проверить статус
  • GET /api/v1/tts/get/?page=1&limit=10 История
Открыть reference

STT API #

API v1 API v2 Realtime STT

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

  • POST /api/v1/stt/post/ для коротких аудио (sync).
  • POST /api/v2/stt/post/ для длинных аудио (async, возвращает task_id).
  • Для realtime audio используйте WebSocket wss://back.aisha.group/api/v1/stt/realtime.
  • Для server streaming интеграций доступен gRPC endpoint back.aisha.group:443.

Endpoints

  • POST /api/v1/stt/post/ Транскрипция короткого аудио
  • GET /api/v1/stt/get/?page=1&limit=10 v1 history список
  • POST /api/v2/stt/post/ Длинное аудио (async)
  • WS /api/v1/stt/realtime?format=webm&token=YOUR_API_KEY Realtime WebSocket транскрипция
Открыть reference

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

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

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

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

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

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

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

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

Машиночитаемая документация

Для AI-агентов и LLM доступна текстовая версия документации.

Для AI-агентов llms-api.txt