API за разработчици
REST API за AI завършвания и достъп до библиотеката с промптове. Достъпен е за Business план и използва споделените кредити на екипа.
Как да започнеш
API ключовете се управляват от собственика на Business работното пространство. Отвори раздел „Екип“, създай ключ и го копирай — показва се само веднъж.
Управление на ключове →Базов адрес
Всички крайни точки са с префикс /api/v1 спрямо домейна на платформата.
https://<your-domain>/api/v1Удостоверяване
Подай ключа в заглавката Authorization. Заявките през HTTPS са задължителни — никога не вграждай ключа в клиентски код.
curl https://<your-domain>/api/v1/me \
-H "Authorization: Bearer ak_live_xxxxxxxx"Лимити
Всеки ключ позволява 60 заявки в минута. Отговорите носят заглавки X-RateLimit-*; при надвишаване връщаме 429 с Retry-After. Месечната квота за AI се отчита спрямо плана на екипа.
Права (scopes)
Всеки ключ носи едно или повече права. Заявка извън правата на ключа връща 403.
ai:complete— AI завършванияprompts:read— Четене на промптове
Крайни точки
/api/v1/meВръща работното пространство, плана, правата на ключа и текущата AI квота. Не разходва квота — идеално за проверка на ключа.
{
"workspaceId": "ws_…",
"plan": "team",
"scopes": ["ai:complete", "prompts:read"],
"quota": { "used": 142, "limit": 5000, "remaining": 4858 }
}/api/v1/ai/completeai:completeИзпълнява еднократно AI завършване със зададен модел. Отчита се към месечната квота на екипа.
curl https://<your-domain>/api/v1/ai/complete \
-H "Authorization: Bearer ak_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "model": "claude", "prompt": "Summarise Q3 in 3 bullets" }'/api/v1/prompts?limit=50&offset=0prompts:readВръща публикуваните промптове с пагинация и филтри по vertical и category.
Грешки
Грешките връщат JSON с поле error и съответен HTTP статус.
401 missing_api_key | invalid_api_key
403 plan_inactive | insufficient_scope
402 quota_exceeded
429 rate_limited (see Retry-After)
502 upstream_error