API Reference
Список расшифровок
GET /transcriptions — список расшифровок в workspace с фильтрацией, сортировкой и пагинацией.
GET /transcriptions
Возвращает страницу расшифровок в workspace, к которому привязан ключ. Лёгкий ответ — без полного текста; для текста используйте Получить расшифровку.
Query-параметры
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
status | string | completed | Фильтр по статусу. Неизвестное значение вернёт пустой список. |
project_id | UUID | — | Только расшифровки этого проекта. UUID можно взять из Списка проектов. |
language | string | — | Код языка, например en, ru. |
date_from | date | — | Созданы не раньше этой даты (YYYY-MM-DD). |
date_to | date | — | Созданы не позже этой даты (YYYY-MM-DD). |
sort | string | -created_at | created_at, -created_at, duration, -duration. Префикс - — по убыванию. |
limit | integer | 20 | Размер страницы, 1–100 (обрезается). |
offset | integer | 0 | Сколько элементов пропустить. |
Запрос
curl -G https://app.memoai.tech/api/v1/developer/transcriptions \
-H "Authorization: Bearer mk_live_your_key_here" \
-d language=ru \
-d date_from=2026-05-01 \
-d sort=-created_at \
-d limit=20import httpx
resp = httpx.get(
"https://app.memoai.tech/api/v1/developer/transcriptions",
headers={"Authorization": "Bearer mk_live_your_key_here"},
params={
"language": "ru",
"date_from": "2026-05-01",
"sort": "-created_at",
"limit": 20,
},
)
resp.raise_for_status()
data = resp.json()const url = new URL("https://app.memoai.tech/api/v1/developer/transcriptions");
url.search = new URLSearchParams({
language: "ru",
date_from: "2026-05-01",
sort: "-created_at",
limit: "20",
}).toString();
const res = await fetch(url, {
headers: { Authorization: "Bearer mk_live_your_key_here" },
});
const data = await res.json();Покажи мои русские встречи за май, сначала новые.
Ассистент вызывает memo_list_transcriptions с language, date_from и sort.
Ответ
200 OK
{
"items": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"title": "Acme — discovery call",
"summary": "Прошлись по текущему процессу и болям...",
"language": "ru",
"duration_seconds": 1840.5,
"speakers": [{ "name": "Алекс" }, { "name": "Джордан" }],
"topics": [{ "title": "Цены" }, { "title": "Онбординг" }],
"media_type": "audio",
"project": { "id": "8b1f3e22-1c4a-4f7e-9a2b-6d5e8c1a2b3c", "name": "Продажи" },
"created_at": "2026-05-20T09:14:00Z",
"updated_at": "2026-05-20T09:31:00Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}Поля ответа
| Поле | Тип | Описание |
|---|---|---|
items[] | array | Расшифровки на этой странице. |
items[].id | UUID | Идентификатор — для Получить / Экспорт. |
items[].title | string | null | Название встречи. |
items[].summary | string | null | Короткое AI-саммари. |
items[].language | string | null | Определённый код языка. |
items[].duration_seconds | number | null | Длительность записи в секундах. |
items[].speakers[] | array | Определённые спикеры. |
items[].topics[] | array | Ключевые темы. |
items[].media_type | string | null | audio или video. |
items[].project | object | null | { id, name }, если привязана к проекту. |
items[].created_at | datetime | Когда создана расшифровка. |
items[].updated_at | datetime | Последнее обновление. |
total | integer | Всего под фильтр (по всем страницам). |
limit | integer | Использованный размер страницы. |
offset | integer | Использованный offset. |
Пагинация
Следующую страницу запрашивайте, увеличивая offset на limit:
# страница 2
curl -G https://app.memoai.tech/api/v1/developer/transcriptions \
-H "Authorization: Bearer mk_live_your_key_here" \
-d limit=20 -d offset=20Конец достигнут, когда offset + len(items) >= total.
Ошибки
| Статус | Когда |
|---|---|
401 | Нет/неверный ключ или ключ передан в URL. |
403 | План без доступа к API. |
429 | Превышен rate limit. |
Подробности — в разделе Ошибки.