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

Все запросы к API LibraChat требуют ключ. Ключ передаётся в заголовке Authorization. Других способов аутентификации нет — ни параметра в URL, ни cookie.

Authorization: Bearer sk-libra-ab12cd...

• Ключ начинается с префикса sk-libra-, дальше идёт около 43 символов.
• На сервере хранится только SHA-256-хеш ключа. Сырое значение показывается один раз — в момент создания.
• В кабинете потом видна лишь укороченная форма вида sk-libra-ab12cd…, по ней ключ можно узнать в списке, но не восстановить.
• Для каждого ключа фиксируется дата последнего использования.

• Откройте кабинет: «Настройки → API».
• Создайте ключ и сразу скопируйте показанное значение в надёжное место (менеджер секретов, переменные окружения сервера).
• На один аккаунт может быть до 10 активных ключей. Попытка создать одиннадцатый вернёт 409 too_many_keys — сначала отзовите ненужный.
• Отзыв ключа действует мгновенно: следующий запрос с ним получит 401.

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

Ключ нужен обоим эндпоинтам — и POST /v1/chat/completions, и GET /v1/models.

curl https://api.librachat.kz/v1/models \
  -H "Authorization: Bearer $LIBRA_API_KEY"

curl https://api.librachat.kz/v1/chat/completions \
  -H "Authorization: Bearer $LIBRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-fast",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

С официальными библиотеками openai ключ подставляется штатным параметром — меняются только адрес и значение ключа.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LIBRA_API_KEY"],   # sk-libra-...
    base_url="https://api.librachat.kz/v1",
)

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

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LIBRA_API_KEY,        // sk-libra-...
  baseURL: "https://api.librachat.kz/v1",
});

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

Тексты ошибок приходят на русском. При 401 в первую очередь проверьте три вещи: слово Bearer перед ключом, отсутствие лишних пробелов и переносов при копировании, и что ключ не отозван в кабинете. Ключ подставляйте целиком — укороченная форма из списка (sk-libra-ab12cd…) не работает.

• Не кладите ключ в клиентский код: браузерный JavaScript, мобильное приложение, публичный репозиторий. Всё, что попало на устройство пользователя, считается раскрытым.
• Вызывайте API с вашего сервера, а клиент пусть ходит к вашему бэкенду.
• Держите ключ в переменных окружения или менеджере секретов, а не в файлах проекта. Файлы вроде .env добавляйте в .gitignore.
• Не пересылайте ключ в переписке и не вставляйте в скриншоты и логи запросов.
• Заведите отдельный ключ на каждый сервис — так при утечке достаточно отозвать один.
• Заметили чужую активность или сомневаетесь — сразу отзовите ключ: отзыв мгновенный, а дата последнего использования поможет понять, работал ли он.