Документация

Подключение IAM.Router One

Установка на устройство

Команда скачивает архив под вашу ОС, проверяет SHA‑256, устанавливает IAM.Launcher, IAM.Edge Gateway и интеграцию Codex. API‑ключ передаётся Launcher через stdin и не попадает в список процессов; внешние provider keys на устройство не передаются. При ошибке installer возвращает прежние файлы и настройки.

curl -fsSL https://one.iamrouter.ru/install.sh | IAM_ROUTER_ONE_RELEASE_BASE=https://one.iamrouter.ru/releases/latest IAM_ROUTER_ONE_API_URL=https://api.one.iamrouter.ru sh

Windows PowerShell:

$env:IAM_ROUTER_ONE_RELEASE_BASE='https://one.iamrouter.ru/releases/latest'; $env:IAM_ROUTER_ONE_API_URL='https://api.one.iamrouter.ru'; irm https://one.iamrouter.ru/install.ps1 | iex

После установки запускайте Claude через iam-claude. Wrapper передаёт профиль Router One, не заменяя vendor CLI. Codex CLI/Desktop настраиваются автоматически при наличии Node.js 18+; для других совместимых клиентов installer создаёт файл окружения.

Безопасное удаление восстанавливает файлы и настройки, существовавшие до первой установки. Изменённые после установки файлы не перезаписываются.

iam-router-one-uninstall

В Windows используйте iam-router-one-uninstall.cmd.

Прямой API

Создайте личный ключ в кабинете и используйте единый model id auto либо доступную модель.

Идентификатор, которого нет в каталоге, не отклоняется, а обрабатывается как auto: маршрутизатор выбирает модель сам, и списывается она. Какая модель ответила, видно всегда — в поле model ответа под именем провайдера и в заголовке x-iam-route-model под именем из нашего каталога. Если важна конкретная модель, проверяйте одно из них.

curl https://api.one.iamrouter.ru/v1/chat/completions \
  -H "Authorization: Bearer iam_live_…" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Привет"}]}'

Совместимые протоколы

OpenAI / DeepSeek: /v1/models, /v1/chat/completions
Anthropic: /v1/messages
Streaming и tool calls проходят через тот же ключ

Ошибки и обращение в поддержку

Каждый ответ несёт заголовок X-IAM-Request-Id, включая успешный. Ошибка повторяет его в теле — это то, что стоит приложить к письму в поддержку:

{"error":{"type":"unauthorized","message":"...","request_id":"9ca8406a1acc94c4"}}

401 unauthorized — ключ неверен, отозван или не передан
400 invalid_request — тело запроса не разобрано или неполно
402 insufficient_balance — бесплатные запросы исчерпаны, баланс не покрывает запрос
413 prompt_too_large — запрос превышает предел размера тела
429 rate_limited — превышен лимит частоты для ключа
502 provider_error, provider_empty_response, empty_completion_no_output_budget — поставщик не ответил или потратил весь лимит вывода на рассуждение; во втором случае помогает больший max_tokens
503 no_provider_available — ни один маршрут для этой модели сейчас не доступен

Список не исчерпывающий: обрабатывайте неизвестный код по его классу HTTP.

Безопасность

Базовый режим изолирует provider keys и применяет лимиты. Расширенный дополнительно классифицирует запрос, маскирует поддерживаемые категории приватных данных и блокирует prompt injection до внешнего вызова.