API Карточки v1

REST-API для интеграции с собственными приложениями. Базовый URL: https://kartochka.ai/api/v1

Аутентификация

Каждый запрос требует Bearer-токен. Создать ключ: Настройки → API-ключи.

Authorization: Bearer krtch_xxxxxxxxxx

Лимиты

USER (бесплатный): 10 запросов/мин
PRO: 30/мин
BUSINESS: 60/мин

При превышении — 429 Too Many Requests.

Стоимость

1 ⭐ — текстовая генерация
3 ⭐ — карточка с фото
4 ⭐ — инфографика

POST /api/v1/generate

Запускает генерацию. Возвращает результат синхронно.

Текстовая (JSON)

POST /api/v1/generate
Content-Type: application/json
Authorization: Bearer krtch_xxx

{
  "type": "text",
  "productName": "Кроссовки Ultra",
  "description": "Лёгкие, 220 г",
  "marketplace": "WB"
}

Ответ:

{
  "id": "clz1...",
  "type": "text",
  "title": "Кроссовки Ultra — лёгкость 220 г",
  "subtitle": "Для бега и города",
  "tag": "HIT",
  "bullets": ["Дышащая сетка", "Подошва EVA", "Вес 220 г"]
}

С изображением (multipart)

POST /api/v1/generate
Content-Type: multipart/form-data
Authorization: Bearer krtch_xxx

image: <file>
meta:  '{"type":"image","productName":"…","style":"CONTRAST","marketplace":"WB"}'

Стили: CONTRAST, ECO, PREMIUM, MINIMAL, CUSTOM.

Ответ:

{
  "id": "clz1...",
  "type": "image",
  "resultImageUrl": "https://...vercel-storage.com/results/.../clz1.png",
  "style": "CONTRAST"
}

GET /api/v1/jobs/:id

Получить статус и результат генерации по ID.

GET /api/v1/jobs/clz1...
Authorization: Bearer krtch_xxx

Коды ответов

200 — успех
400 — невалидные данные
401 — невалидный API-ключ
402 — недостаточно звёзд
404 — не найдено
429 — превышен rate-limit
502 — ошибка генерации (звёзды возвращены)

Поддержка

Вопросы — в Telegram @andreie.