LLM Router
Руководства

Первый запрос к модели

Отправьте chat-completion через API моделей в формате OpenAI API.

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

  • Разработчикам — проверка интеграции.
  • Администраторам — smoke-тест после настройки моделей и ключей.

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

  • Адрес API моделей (его сообщает администратор платформы).
  • API-ключ организации — см. Создание API-ключа.
  • Имя модели из каталога (например, gpt-4o-mini).

Шаг 1. Убедитесь, что модель включена

В личном кабинете (раздел Модели) или через API:

TOKEN="<session-token>"
ORG_ID="<org-id>"

curl -s "https://api.example.com/api/organizations/$ORG_ID/models" \
  -H "Authorization: Bearer $TOKEN"

Включите модель при необходимости:

curl -s -X PATCH "https://api.example.com/api/organizations/$ORG_ID/models" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabledModels": ["gpt-4o-mini"]}'

Шаг 2. Chat completion

Подставьте адрес API моделей и API-ключ:

MODELS_API_URL="https://models.example.com"
API_KEY="sk-…"

curl -s "$MODELS_API_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Скажи одним предложением, что такое LLM Router."}
    ]
  }'

Успешный ответ — JSON с полем choices[0].message.content.

Шаг 3. Проверьте расходы (опционально)

Расход появится в разделе Биллинг после обработки usage (обычно в течение нескольких секунд). Сводку можно запросить через API платформы:

curl -s "https://api.example.com/api/organizations/$ORG_ID/usage" \
  -H "Authorization: Bearer $TOKEN"

Локально: http://localhost:4000 для API моделей, ключ из кабинета или DEMO_GATEWAY_API_KEY для smoke (./scripts/smoke-e2e.sh).

Совместимость API

API моделей поддерживает эндпоинты в стиле OpenAI: /v1/chat/completions, /v1/models и др. Используйте официальные SDK OpenAI, указав base_url вашего API моделей.

Типичные ошибки

ОшибкаПричина
401 UnauthorizedНеверный или отозванный API-ключ
403 / model not allowedМодель не включена для организации или ключа
5xx от провайдераМодель недоступна у поставщика — обратитесь к администратору платформы

Что дальше

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