Руководство пользователя

Протоколы API

LMU AI поддерживает три входящих протокола — Anthropic, OpenAI Compatible и Gemini native. Одна таблица, чтобы выбрать правильный Base URL и эндпоинт и избежать ошибок.

LMU AI поддерживает три входящих протокола: Anthropic, OpenAI Compatible и нативный Gemini v1beta. Каждый эндпоинт использует ваш API-ключ LMU AI с префиксом sk-, а модели, которые вы фактически можете вызывать, определяются группой ключа.

Сначала запомните две вещи

  • «Какой протокол» определяется клиентом, SDK и сценарием использования. Anthropic SDK использует /v1/messages, OpenAI SDK использует /v1/chat/completions или /v1/responses, а нативные вызовы изображений Gemini используют /v1beta/models/{model}:generateContent.
  • «Какие модели вы можете вызывать» определяется группой вашего API-ключа (апстрим-аккаунтом, стоящим за вашей подпиской / планом пополнения), что является отдельным измерением по отношению к входящему протоколу.

Иными словами: неправильный протокол выдаёт прямую ошибку 401 / 404; правильный протокол с моделью вне диапазона вашей группы возвращает ошибку недоступности модели.

Самая частая ошибка возникает из-за неправильного протокола

  • Base URL протокола Anthropic не включает суффикс /v1
  • Base URL SDK протокола OpenAI, как правило, включает суффикс /v1
  • Нативный протокол Gemini использует https://api.lmuai.com в качестве хоста и вызывает полный путь /v1beta/...

Ошибка здесь вызывает 400 / 401 / 404. Прежде чем настраивать инструмент или писать код, убедитесь, какой протокол ожидает клиент.


Выберите протокол с первого взгляда

ПротоколBase URLТипичные инструменты
Протокол Anthropichttps://api.lmuai.comClaude Code (CLI / десктоп / расширение VS Code), официальный SDK anthropic, Cherry Studio, Kilo Code с Claude / китайскими моделями, любой Anthropic-совместимый клиент
OpenAI Compatiblehttps://api.lmuai.com/v1Codex CLI, Codex App, Cursor / Cline / Roo Code / OpenCode, официальный SDK openai, расширения VS Code с GPT, любой OpenAI-совместимый клиент
Нативный Gemini v1betahttps://api.lmuai.comНативный SDK / HTTP-клиенты Gemini, текст-в-изображение и изображение-в-изображение Gemini, список моделей и generateContent

Все три протокола используют ключ LMU AI, начинающийся с sk-:

  • Протокол Anthropic: Authorization: Bearer <YOUR_API_KEY> или x-api-key: <YOUR_API_KEY>
  • OpenAI Compatible: Authorization: Bearer <YOUR_API_KEY>
  • Нативный Gemini: рекомендуется x-goog-api-key: <YOUR_API_KEY>, Bearer также принимается

Протокол Anthropic

Base URL: https://api.lmuai.com (без /v1)

Эндпоинты:

  • POST /v1/messages — диалоговый обмен сообщениями
  • POST /v1/messages/count_tokens — подсчёт токенов
  • GET /v1/models — список доступных моделей

Пример на Python SDK:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.lmuai.com",
    api_key="sk-xxxxxxxx",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.content[0].text)

Пример curl:

curl -X POST https://api.lmuai.com/v1/messages \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"Hello"}]
  }'

Почему у SDK base_url без /v1, а у curl с /v1?

По соглашению base_url официального SDK Anthropic опускает /v1; SDK внутренне добавляет пути вроде /v1/messages. Когда вы пишете curl вручную, вы указываете полный путь /v1/messages. Оба указывают на один и тот же эндпоинт.


Протокол OpenAI

Base URL: https://api.lmuai.com/v1 (с /v1)

Эндпоинты:

  • POST /chat/completions — стандартный Chat Completions API
  • POST /responses — OpenAI Responses API (включая подпути /responses/{id})
  • POST /images/generations, POST /images/edits — генерация / редактирование изображений

Пример на Python SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmuai.com/v1",
    api_key="sk-xxxxxxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Пример curl:

curl -X POST https://api.lmuai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"Hello"}]
  }'

Нативный протокол Gemini

Base URL: https://api.lmuai.com

Основные эндпоинты:

  • GET /v1beta/models — список нативных моделей Gemini
  • GET /v1beta/models/{model} — запрос конкретной модели
  • POST /v1beta/models/{model}:generateContent — генерация текста, текст-в-изображение и изображение-в-изображение
  • POST /v1beta/models/{model}:streamGenerateContent?alt=sse — потоковая генерация

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

x-goog-api-key: YOUR_API_KEY

Минимальный пример текст-в-изображение:

curl --request POST \
  'https://api.lmuai.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
  -H 'x-goog-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "an orange cat wearing an astronaut helmet"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }'

Эндпоинт изображений Gemini — это не /v1/chat/completions

Модели изображений Gemini используют нативный generateContent. Полные сведения о текст-в-изображение, изображение-в-изображение, 1K / 2K / 4K и разборе Base64 см. в Gemini Image API.

Модели изображений GPT см. в GPT Image API, а модели изображений Grok — в Grok Image API. Для больших офлайн-задач Gemini см. Gemini Batch Image API.


Протокол и доступные модели — это две разные вещи

Какие модели может вызывать ваш ключ, полностью определяется апстрим-аккаунтом, привязанным к его группе, независимо от того, каким протоколом вы вызываете:

Апстрим вашей группыМодели, которые вы фактически можете вызывать
Только аккаунт OpenAIТолько серия GPT
Только аккаунт ClaudeТолько серия Claude (даже если вы вызываете протоколом OpenAI, бэкенд транслирует протокол, но диапазон моделей не меняется)
Только апстрим китайских моделей (например, GLM / Kimi)Только соответствующие китайские модели
Маршрутизация моделей, настроенная в бэкенде (мультиапстрим-группа)Маршрутизация по имени модели к разным апстримам, может охватывать несколько брендов — точный диапазон зависит от конфигурации группы

Итак:

  • Выбор протокола Anthropic, OpenAI Compatible или нативного Gemini определяет формат входящего запроса; фактический диапазон моделей по-прежнему определяется группой API-ключа.
  • Чтобы узнать, какие модели может вызывать ваш текущий ключ, проверьте список моделей группы на странице деталей API Keys или на странице Available Models в консоли.

О группе Claude Max

Группа Claude Max поддерживает только протокол Anthropic

Группа Claude Max предназначена только для Claude Code, поэтому может использовать только протокол Anthropic (https://api.lmuai.com).

Если вы используете ключ из группы плана Claude Max:

  • ✅ Он работает в Claude Code (CLI / десктоп / расширение VS Code)
  • ❌ Он не может использоваться с Codex CLI, Cursor, Cherry Studio или любым инструментом, использующим протокол OpenAI
  • ❌ Он не может быть указан как https://api.lmuai.com/v1

Чтобы использовать инструмент на протоколе OpenAI, переключитесь на ключ из группы с оплатой по факту / обычной подписки (точный набор доступных моделей по-прежнему зависит от приобретённой вами группы плана).


Устранение неполадок

СимптомОбычная причинаЧто делать
401 UnauthorizedBase URL использует неправильный протокол / опечатка в ключе / IDE не перезапущенаПроверьте, что Base URL соответствует протоколу инструмента; перезапустите IDE для перезагрузки конфигурации
404 Not FoundURL протокола OpenAI без /v1, URL Anthropic ошибочно с /v1 или путь Gemini без /v1beta/models/...Перепроверьте Base URL и полный эндпоинт по таблице выше
Модель недоступна / No available accountsВызвана модель вне диапазона вашей группы (например, вызов GPT с группой Claude Max)Подтвердите модели, которые фактически включает ваша группа, на странице Available Models, или переключитесь на группу, включающую целевую модель
429 Too Many RequestsДневная квота исчерпанаСм. FAQ

Дополнительные сведения об устранении неполадок см. в FAQ.


Следующие шаги

Как только вы правильно настроите протокол и Base URL, выберите нужный инструмент:

Последнее обновление:

На этой странице