К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/transcribe

Распознать короткую запись, отправив raw audio, не multipart.

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/transcribe
ДоступCookie кабинета · Mini App (TMA)
Scope для ключейключи не принимаются – только кабинет (403 CREDENTIAL_NOT_ALLOWED)
operationIdtranscribe

Описание#

Распознать короткую запись, отправив raw audio, не multipart. Не более 2 MiB и 120 секунд (технический допуск длительности 3 секунды); чтение тела ограничено 20 секундами. Audio не сохраняется. Без настроенного Groq – 503.

Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.

Path: параметров нет.

Query: нет объявленных полей.

Body: обязательные raw bytes; Content-Type: audio/webm, audio/ogg, audio/mp4.

Ответ · статус и структура

Ответ: 200 application/json, TranscribeResponse.

Краткая форма: { text: string, durationSec: number, remainingSecToday: integer }.

Пример JSON; значения демонстрационные.

json
{
  "text": "У меня небольшая студия дизайна, хочу агента для заявок.",
  "durationSec": 6.4,
  "remainingSecToday": 1793
}

Ошибки: 401 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 403 ORIGIN_REJECTED, 422 VALIDATION_FAILED, 409 BUSY, 429 DAILY_LIMIT, 503 DICTATION_UNAVAILABLE, 403 CREDENTIAL_NOT_ALLOWED; общие ошибки.

Лимиты: 1 запись одновременно; по умолчанию 1800 учитываемых секунд/день МСК; списание ceil(durationSec), минимум 10 секунд за вызов провайдера.

bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/transcribe \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: audio/webm' \
  --data-binary @example.webm

Ответы по контракту#

СтатусТипСхемаОписание
200application/jsonTranscribeResponseУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, BUSY, DAILY_LIMIT, DICTATION_UNAVAILABLE

Машиночитаемый контракт: openapi.json, операция transcribe.