документация · openai-compatible

Как пользоваться API

Сервис полностью совместим с OpenAI. Любой клиент или SDK работает без изменений — нужно лишь подменить base_url и ключ.

Открыть интерактивный Swagger →Получить ключ

шаг за шагом

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

Зарегистрируйтесь в кабинете.
Создайте API-ключ — он появится в статусе pending. Сырой ключ показывается один раз — сохраните его.
Дождитесь одобрения супер-админом — статус станет approved.
Подставьте ключ и хост в любой OpenAI-клиент. Готово.

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

Ключи и доступ

Все запросы к /v1/* авторизуются заголовком Authorization: Bearer sk-emb-…. Ключ работает только в статусе approved и только для моделей, которые включил администратор. Неодобренный или отозванный ключ получает ошибку в формате OpenAI.

примеры

curl

embeddings.sh

curl https://llm.korateam.ru/v1/embeddings \
  -H "Authorization: Bearer sk-emb-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nomic-embed-text",
    "input": "привет, мир"
  }'

chat-stream.sh

curl https://llm.korateam.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-emb-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen2.5:7b",
    "messages": [{"role": "user", "content": "Привет!"}],
    "stream": true
  }'

примеры

Python (openai SDK)

pip install openai

example.py

from openai import OpenAI

client = OpenAI(base_url="https://llm.korateam.ru/v1", api_key="sk-emb-...")

# эмбеддинги
emb = client.embeddings.create(model="nomic-embed-text", input="привет, мир")
print(len(emb.data[0].embedding))

# чат
r = client.chat.completions.create(
    model="qwen2.5:7b",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(r.choices[0].message.content)

# стриминг
for chunk in client.chat.completions.create(
    model="qwen2.5:7b",
    messages=[{"role": "user", "content": "Считай до 5"}],
    stream=True,
):
    print(chunk.choices[0].delta.content or "", end="", flush=True)

примеры

JavaScript / TypeScript (openai SDK)

npm i openai

example.ts

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://llm.korateam.ru/v1",
  apiKey: "sk-emb-...",
});

const emb = await client.embeddings.create({
  model: "nomic-embed-text",
  input: "привет, мир",
});

const stream = await client.chat.completions.create({
  model: "qwen2.5:7b",
  messages: [{ role: "user", content: "Привет!" }],
  stream: true,
});
for await (const chunk of stream)
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

справочник

Эндпоинты

Метод	Путь	Назначение	Auth
POST	/v1/embeddings	Эмбеддинги текста	API-ключ
POST	/v1/chat/completions	Чат-комплишены (+ стриминг)	API-ключ
GET	/v1/models	Список доступных моделей	API-ключ
POST	/auth/register	Регистрация	—
POST	/auth/login	Вход в кабинет	—
POST	/keys	Создать API-ключ (→ pending)	JWT
GET	/keys	Мои ключи	JWT

Полный справочник со схемами запросов/ответов и кнопкой «Try it out» — интерактивный Swagger.