Перейти к основному содержанию

​
Короткий ответ

Base URL должен соответствовать protocol, который ожидает инструмент. Claude Code обычно использует корневой Anthropic-compatible адрес. Codex CLI, Cursor, Cline, OpenCode, OpenClaw и другие внешние инструменты обычно используют OpenAI-compatible адрес с /v1. В LLMEasy:
СценарийBase URL
Claude Code / Anthropic-compatiblehttps://www.llmeasy.ru
Codex CLI / OpenAI-compatiblehttps://www.llmeasy.ru/v1
Cursor, Cline, OpenCode, OpenClawhttps://www.llmeasy.ru/v1
Не угадывайте путь вручную. API Key, Base URL и Model ID должны относиться к одному provider или gateway.

​
Почему Base URL отличаются

Разные SDK по-разному добавляют пути к адресу.
Protocol или тип инструментаЧастое поведение
OpenAI-compatible SDKОбычно вызывает chat completions, responses и другие ресурсы внутри /v1
Anthropic-compatible SDKОбычно сам добавляет путь messages endpoint, поэтому не нужно повторно добавлять /v1
Встроенный provider в инструментеМожет добавлять путь автоматически или требовать полный Base URL
Одинаковое имя модели не значит, что везде подойдет один Base URL. Нужно сопоставить protocol инструмента, Base URL, API Key, группу ключа и Model ID.

​
Быстрая таблица

ИнструментРекомендуемая настройка
Claude Codehttps://www.llmeasy.ru, API Key из группы Claude
Claude Desktop GatewayПо инструкции Gateway, включая auth scheme
Codex CLIhttps://www.llmeasy.ru/v1, API Key из группы GPT
Cursorhttps://www.llmeasy.ru/v1, API Key из группы GPT
Clinehttps://www.llmeasy.ru/v1, provider OpenAI Compatible
OpenCode / OpenClawhttps://www.llmeasy.ru/v1, API Key из группы GPT

​
Частые ошибки

Ошибка или симптомВозможная причина
404 Not FoundПуть в Base URL не совпадает с тем, что ожидает SDK
model not foundModel ID не относится к текущей группе ключа или provider
invalid_api_keyAPI Key и Base URL взяты из разных сервисов
Авторизация проходит, но модель недоступнаГруппа ключа и Model ID не совпадают
Запросы постоянно падаютAnthropic-compatible адрес указан в OpenAI-compatible инструменте или наоборот

​
Рекомендуемый порядок проверки

  1. Проверьте, какой API ожидает инструмент: OpenAI-compatible или Anthropic-compatible.
  2. Проверьте, соответствует ли Base URL этому protocol.
  3. Проверьте, что API Key относится к тому же сервису.
  4. Проверьте, что Model ID взят из model plaza и относится к текущей группе ключа.
  5. Отправьте минимальный тестовый запрос, например hello.

​
Примеры кода

OpenAI-compatible инструменты обычно используют адрес с /v1: 
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.llmeasy.ru/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)
Claude / Anthropic-compatible настройки обычно используют корневой адрес: 
import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://www.llmeasy.ru"
)

message = client.messages.create(
    model="your-claude-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

​
О LLMEasy

LLMEasy поддерживает Anthropic-compatible и OpenAI-compatible доступ. Вы можете управлять API Keys, балансом и usage records в одном dashboard, но каждый клиент должен использовать адрес protocol, который он поддерживает. Короткое правило: Claude Code использует https://www.llmeasy.ru; Codex CLI, Cursor, Cline, OpenCode и OpenClaw используют https://www.llmeasy.ru/v1.

​
Связанные материалы