Руководства по интеграции

Эти руководства показывают, как направить популярные клиенты и агенты на шлюз ru-llm. ru-llm предоставляет OpenAI-совместимую поверхность (/v1/chat/completions) и Anthropic-совместимую поверхность (/v1/messages) на одном базовом URL, поэтому большинство инструментов начинают работать после изменения двух настроек: базового URL и API-ключа.

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

Базовый URL — https://api.ru-llm.relay2.xyz (замените на URL вашего шлюза при self-hosting).
- OpenAI-клиенты указывают на https://api.ru-llm.relay2.xyz/v1.
- Anthropic-клиенты указывают на https://api.ru-llm.relay2.xyz.
API-ключ — ключ sk-ru-… из консоли → API-ключи. Принимается как Authorization: Bearer sk-ru-…, так и x-api-key: sk-ru-… на обеих поверхностях.
ID модели — см. Модели и цены. В примерах ниже используются gpt-5.5, claude-sonnet-4-6 и claude-opus-4-8.

Первый запрос

OpenAI-совместимый (chat completions)

curl https://api.ru-llm.relay2.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-ru-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello, world!"}]
  }'

Ответ:

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Hello! How can I help you today?"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 9, "completion_tokens": 10, "total_tokens": 19}
}

Anthropic-совместимый (messages)

curl https://api.ru-llm.relay2.xyz/v1/messages \
  -H "x-api-key: sk-ru-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello, world!"}]
  }'

Выберите клиент

Claude Code

Направьте CLI/IDE-агент Anthropic на шлюз двумя переменными окружения. Открыть →

Codex

Добавьте собственного OpenAI-провайдера в config.toml. Открыть →

Генерация изображений

Создавайте изображения через gpt-image-2 и /v1/images/generations. Открыть →

Генерация видео

Рендерьте видео через Seedance и асинхронный видео-эндпоинт. Открыть →

Универсальные OpenAI / Anthropic SDK

Любой клиент на официальных SDK OpenAI или Anthropic работает после переопределения базового URL и ключа — см. справочники OpenAI-совместимого и Anthropic-совместимого API с примерами на Python и TypeScript.