Загрузка файла

Формат запроса

Файл — это тело запроса. Без multipart-форм, без JSON-оберток, без протоколов чанков:

Query-параметры

Все необязательные:

Поддерживаемые языки

auto (по умолчанию — язык определяется по аудио) или один из:

en, es, ru, zh, hi, ar, pt, bn, fr, de, ja, ko, tr, it, vi, pl, uk, nl, id, th, fa, sv, cs, ro, el, hu, da, fi, no, sk, he, ms, bg, hr, sr, sl, lt, lv, et, ta, te, mr, ur, sw, ml, kn, gu, pa, my, ne, si, km, lo, az, kk, uz, ka, hy, sq, bs, mk, is, mn, tg, tk, tt, ca, eu, gl, cy, af, tl, jw, su, yo, ha, so, am, sn, mg, ln, mt, lb, oc, br, nn, fo, sd, ps, ht, mi, haw, yi, ba, be, as, bo, sa, la

Двухбуквенные коды ISO 639-1 (плюс haw и jw). Неподдерживаемое значение вернет 422.

Запрос

curl -X POST "https://app.memoai.tech/api/v1/developer/transcriptions?language=ru" \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H 'Content-Disposition: attachment; filename="standup.mp3"' \
  --data-binary @standup.mp3

import httpx

with open("standup.mp3", "rb") as f:
    resp = httpx.post(
        "https://app.memoai.tech/api/v1/developer/transcriptions",
        params={"language": "ru"},
        headers={
            "Authorization": "Bearer mk_live_your_key_here",
            "Content-Disposition": 'attachment; filename="standup.mp3"',
        },
        content=f,        # стримится с диска — работает и для 2 ГБ
        timeout=httpx.Timeout(10, write=None),  # не обрывать долгую отправку
    )
resp.raise_for_status()
t = resp.json()
print(t["uuid"], t["status"])   # "3fa85f64-…" "queued"

import { openAsBlob } from "node:fs"; // Node 20+

const res = await fetch(
  "https://app.memoai.tech/api/v1/developer/transcriptions?language=ru",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer mk_live_your_key_here",
      "Content-Disposition": 'attachment; filename="standup.mp3"',
    },
    body: await openAsBlob("standup.mp3"), // стрим, Content-Length выставится сам
  },
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const t = await res.json();
console.log(t.uuid, t.status); // "3fa85f64-…" "queued"

Ответ

201 Created — файл принят и поставлен в очередь. Расшифровка идет асинхронно.

{
  "id": 12345,
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "queued"
}

Статусы и опрос

Опрашивайте GET /transcriptions/{uuid} раз в 5–10 секунд до терминального статуса:

import time

while True:
    t = httpx.get(f"{BASE}/transcriptions/{uuid}", headers=HEADERS).json()
    if t["status"] in ("completed", "failed", "insufficient_balance"):
        break
    time.sleep(10)

Частые значения error_code при failed:

Лимиты и списание

Анти-абьюз ограничители (суточные капы на ключ, лимит одновременных загрузок) выставлены сильно выше нормального использования — если получили 429 с upload_quota_exceeded, напишите в поддержку, поднимем.

Ретраи

Без предосторожностей повтор загрузки, ответ на которую вы не увидели (соединение оборвалось после последнего байта), создал бы вторую расшифровку и второе списание. Заголовок Idempotency-Key решает это:

• Передавайте уникальное значение на файл (UUID идеален) с каждой попыткой.
• Если файл уже принят под этим ключом, придет 200 с оригинальным uuid вместо дубля — без двойного списания, квоты не тронуты.
• Запрос с тем же ключом, который еще в полете, вернет 409 idempotency_conflict — подождите Retry-After и повторите.
• Добавляйте джиттер: спите случайную долю Retry-After, а не ровно указанное время. Если лимит поймали сразу много клиентов, одновременное пробуждение просто воссоздаст очередь.
• Запоминается только успех (на 24 часа); после неудачной попытки ключ свободен для повтора.

curl -X POST "https://app.memoai.tech/api/v1/developer/transcriptions" \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H 'Content-Disposition: attachment; filename="standup.mp3"' \
  -H "Idempotency-Key: 7f3a2b1c-9d4e-4f5a-8b6c-1d2e3f4a5b6c" \
  --data-binary @standup.mp3

Ошибки

Полный справочник и правила ретраев — в разделе Ошибки.