REST API
POST/ api/ v1/ transcribe
Распознать короткую запись, отправив raw audio, не multipart.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | transcribe |
Описание#
Распознать короткую запись, отправив raw audio, не multipart. Не более 2 MiB и 120 секунд (технический допуск длительности 3 секунды); чтение тела ограничено 20 секундами. Audio не сохраняется. Без настроенного Groq – 503.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: обязательные raw bytes; Content-: audio/, audio/, audio/.
Ответ · статус и структура
Ответ: 200 application/, TranscribeResponse.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"text": "У меня небольшая студия дизайна, хочу агента для заявок.",
"durationSec": 6.4,
"remainingSecToday": 1793
}Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 409 , 429 , 503 , 403 ; общие ошибки.
Лимиты: 1 запись одновременно; по умолчанию 1800 учитываемых секунд/день МСК; списание ceil(durationSec), минимум 10 секунд за вызов провайдера.
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Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | TranscribeResponse | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, BUSY, DAILY_LIMIT, DICTATION_UNAVAILABLE |
Машиночитаемый контракт: openapi.json, операция transcribe.