# POST /api/v1/transcribe

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

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

## Описание

Распознать короткую запись, отправив 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](/docs/schemas#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`; [общие ошибки](/docs/errors).

**Лимиты:** 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
```

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [TranscribeResponse](/docs/schemas#transcriberesponse) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, BUSY, DAILY_LIMIT, DICTATION_UNAVAILABLE |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `transcribe`.
