Примеры SDK (Python и Node.js)

Подключение приложений к API моделей через официальные OpenAI-совместимые SDK.

Кому подходит

Разработчикам — быстрая интеграция без ручных HTTP-запросов.
Администраторам — проверка, что ключ и модель работают из кода.

Что понадобится

Параметр	Где взять
Базовый URL API моделей	у администратора платформы (например, `https://models.example.com`)
API-ключ (`sk-…`)	создание ключа — секрет показывается один раз
Имя модели	каталог в кабинете, например `gpt-4o-mini`

API моделей совместим с форматом OpenAI API (/v1/chat/completions и др.).

Python (openai)

Установка:

pip install openai

Пример chat completion:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LLM_ROUTER_API_KEY"],  # sk-… из кабинета
    base_url=os.environ["LLM_ROUTER_BASE_URL"],  # https://models.example.com/v1
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "Скажи одним предложением, что такое LLM Router."}
    ],
)

print(response.choices[0].message.content)

Переменные окружения:

export LLM_ROUTER_BASE_URL="https://models.example.com/v1"
export LLM_ROUTER_API_KEY="sk-…"

Node.js (openai)

Установка:

npm install openai

Пример (ES modules):

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLM_ROUTER_API_KEY,
  baseURL: process.env.LLM_ROUTER_BASE_URL, // https://models.example.com/v1
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    { role: "user", content: "Скажи одним предложением, что такое LLM Router." },
  ],
});

console.log(response.choices[0].message.content);

CommonJS:

const OpenAI = require("openai").default;

const client = new OpenAI({
  apiKey: process.env.LLM_ROUTER_API_KEY,
  baseURL: process.env.LLM_ROUTER_BASE_URL,
});

Обработка ошибок

Ситуация	Типичный код	Действие
Неверный или отозванный ключ	401	Проверьте секрет; при необходимости отзовите и создайте новый
Модель недоступна ключу	400 / 403	Проверьте список моделей ключа и включение моделей
Превышен бюджет	429 / 402	Увеличьте лимит или дождитесь нового периода — см. лимиты

Streaming (опционально)

Python:

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет!"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js:

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