№ 4 · Документация

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

LUMINA — OpenAI-совместимый API к Claude 5 и Kimi K3. Если у вас есть код под OpenAI, вы уже почти готовы. Поменяйте baseURL и ключ — дальше всё работает. Сейчас доступен бесплатный режим; launch-цены опубликованы отдельно и требуют подключённого биллинга.

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

Все запросы требуют заголовок Authorization: Bearer <ваш ключ>. Ключ выдаётся в кабинете и начинается с lum-.

Безопасность. Ключ показывается один раз при создании. Храните его в переменных окружения, не в коде.

Доступные модели

Модель	id	Контекст	Тариф
Claude Opus 5	claude-opus-5	1M	pro
Claude Sonnet 5	claude-sonnet-5	1M	pro
Claude Fable 5	claude-fable-5	1M	pro
Claude Haiku 4.5	claude-haiku-4-5	200K	free
Kimi K3	kimi-k3	256K	free

Python

example.py

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Node.js

example.mjs

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://YOUR_LUMINA_HOST/v1",
  apiKey: "lum-ВАШ_КЛЮЧ",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(resp.choices[0].message.content);

cURL

terminal

curl https://YOUR_LUMINA_HOST/v1/chat/completions \
  -H "Authorization: Bearer lum-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role":"user","content":"Привет!"}]
  }'

Стриминг

Передайте "stream": true — ответ придёт как Server-Sent Events. Пример ниже использует openai ≥ 1.40 (метод .stream()).

stream.py

with client.chat.completions.stream(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Расскажи анекдот"}],
) as stream:
    for event in stream:
        if event.type == "content.delta":
            print(event.delta, end="")

Коды ошибок

Код	Тип	Значение
200	—	успех
401	unauthorized	неверный или истёкший ключ
429	rate_limit_error	слишком много запросов (60/мин)
429	daily_limit_error	дневной лимит бесплатного тарифа исчерпан
403	model_access_error	модель недоступна на вашем тарифе
400	invalid_request_error	ошибка в теле запроса
503	upstream_unavailable	временно недоступно, повторите позже
500	internal_error	внутренняя ошибка

Совместимость. LUMINA совместим с OpenAI SDK, LangChain, opencode, curl и любым HTTP-клиентом. Формат запроса и ответа — как у OpenAI.