API Reference
Workspace и лимиты
GET /workspace — проверьте доступные минуты, лимиты тарифа и права своего ключа перед пакетной загрузкой.
GET /workspace
Возвращает workspace ключа, текущий баланс минут, лимиты тарифа и права самого ключа. Вызовите
перед большой пачкой — вместо того чтобы узнать про insufficient_balance на пятидесятом
файле.
Запрос
curl https://app.memoai.tech/api/v1/developer/workspace \
-H "Authorization: Bearer mk_live_your_key_here"import httpx
resp = httpx.get(
"https://app.memoai.tech/api/v1/developer/workspace",
headers={"Authorization": "Bearer mk_live_your_key_here"},
)
resp.raise_for_status()
ws = resp.json()
print("осталось минут:", ws["balance"]["available_minutes"])const res = await fetch("https://app.memoai.tech/api/v1/developer/workspace", {
headers: { Authorization: "Bearer mk_live_your_key_here" },
});
const ws = await res.json();
console.log("осталось минут:", ws.balance.available_minutes);Сколько у меня осталось минут расшифровки?
Ассистент проверит баланс workspace перед тем, как запускать загрузки.
Ответ
200 OK
{
"workspace": { "id": "a1b2c3d4-...", "name": "Product Team" },
"balance": { "available_minutes": 1240.5 },
"limits": {
"max_file_size_mb": 2048,
"concurrency": 3,
"max_duration_hours": 10
},
"key": { "scopes": ["read", "uploads:write"], "expires_at": null }
}| Поле | Тип | Описание |
|---|---|---|
workspace | object | Workspace, к которому привязан ключ. |
balance.available_minutes | number | Минуты, которые еще можно потратить — уже с учетом файлов в очереди и обработке. |
limits.max_file_size_mb | integer | Кап размера файла при загрузке. |
limits.concurrency | integer | Файлов в параллельной обработке; лишние ждут в queued. |
limits.max_duration_hours | integer | Максимальная длительность записи. |
key.scopes | string[] | Что умеет этот ключ: read, uploads:write, transcriptions:delete. |
key.expires_at | datetime | null | Срок действия ключа, если задан. |
Для планирования верьте именно available_minutes: из него уже вычтены резервации за файлы в
обработке, поэтому два скрипта не получат обещание одних и тех же минут.
Ошибки
| Статус | Когда |
|---|---|
401 | Нет/неверный ключ или ключ передан в URL. |
403 | План без доступа к API. |
429 | Превышен rate limit. |