kivlaНачать
API v1 · beta

Первый запрос

kivla совместим с OpenAI SDK. Замените базовый URL, укажите ключ и выберите опубликованную модель.

Важно про usage

Токены обязательной platform policy входят в usage и стоимость запроса. Содержание policy не возвращается клиенту.

1. Получите ключ

В кабинете выпустите тестовый или боевой ключ. Боевой ключ доступен после подтверждённой почты, а сам секрет показывается один раз.

2. Отправьте запрос

cURL
curl https://api.kivla.ru/v1/responses \
  -H "Authorization: Bearer $KIVLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kivla-text",
    "input": "Привет!"
  }'

3. Прочитайте метаданные

Помимо совместимого ответа kivla возвращает request_id, фактически использованный маршрут, data_zone, cost_rub и подробный usage.

POST /responsesПолная схема

OpenAI‑совместимый endpoint с идемпотентностью, прозрачным usage и контролируемой маршрутизацией.