Документация без лишнего слоя

Быстрый старт

Создайте ключ в кабинете и передайте его как Bearer-токен. Для начала достаточно заменить базовый адрес в уже существующем OpenAI-клиенте.

from openai import OpenAI

client = OpenAI(
    base_url="https://lumina-ai.work/v1",
    api_key="lum-ВАШ_КЛЮЧ",
)

r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Привет!"}],
)

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://lumina-ai.work/v1",
  apiKey: process.env.LUMINA_API_KEY,
});
const r = await client.chat.completions.create({ model: "claude-sonnet-5", messages: [{ role: "user", content: "Привет!" }] });

curl https://lumina-ai.work/v1/chat/completions \
  -H "Authorization: Bearer $LUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Привет!"}]}'

Запрос

Метод POST /v1/chat/completions принимает JSON-тело в формате OpenAI. Обязательны model и непустой массив messages.

Стриминг

Установите stream: true. Ответ приходит как поток SSE, каждая строка содержит JSON-объект в формате OpenAI, завершается маркером [DONE].

data: {"id":"chatcmpl_...","choices":[{"delta":{"content":"Текст"}}]}
data: [DONE]

Модели

Список можно получить запросом GET /v1/models. Доступ к PRO-моделям появляется после пополнения баланса.

Лимиты и биллинг

FREE даёт 5 запросов в минуту и 20 в сутки. PRO даёт 50 запросов в минуту без дневного лимита. На PRO токены списываются с баланса по ставкам из таблицы цен.

Перед запросом резервируется оценка стоимости, после ответа она пересчитывается по фактическому usage. При ошибке резерв возвращается.

Коды ошибок