IRI Gateway:
один API
curated-модели

Зачем ещё один API-шлюз

Рынок LLM API уже переполнен: OpenRouter, Together, Azure, прямые ключи OpenAI и Anthropic. Проблема не в доступе к моделям — проблема в операционке: разные форматы, разные лимиты, разные счета, разные политики доступа из России.

IRI Gateway решает прикладную задачу для команд в РФ и СНГ:

• 01
  Один ключ Claude, GPT, Gemini, DeepSeek, Llama — через единый Bearer token.
• 02
  Рубли Баланс, пополнение по счёту, прозрачные цены за 1M токенов.
• 03
  Curated-каталог curated-модели IRI в ключе (список — кабинет и GET /v1/models) + публичный каталог-справочник — без шума сотен dead endpoints.
• 04
  Failover Upstream-цепочки через LiteLLM — если провайдер упал, запрос уходит дальше.

Архитектура в двух слоях

Публичный слой — сайт agi-iri.ru/gateway: документация, каталог моделей, кабинет, регистрация. Статика на Timeweb, backend на DigitalOcean.

API-слой — FastAPI-сервис `/opt/iri-gateway/` (порт 8010). Публичный URL сейчас: https://aioperatingsystem.ru/iri-gateway/v1/, с переездом на api.agi-iri.ru.

Как проходит запрос

1. Клиент шлёт стандартный OpenAI POST /v1/chat/completions.
2. Gateway проверяет API-ключ и баланс (или free-tier лимит).
3. proxy.py резолвит модель → upstream chain → LiteLLM completion/stream.
4. Usage пишется в биллинг; streaming отдаётся клиенту с stream_options.include_usage.

Free-tier: попробовать без карты

Две модели бесплатны: Gemini 2 Flash и Llama 3.2 3B. IRI Zero — бесплатный режим на доступной бесплатной вычислительной ёмкости. Если бесплатная ёмкость временно исчерпана, запрос не переключается на платную модель автоматически. Free-запросы не трогают платный баланс — удобно для прототипов и обучения команды.

Пример: первый запрос

curl https://aioperatingsystem.ru/iri-gateway/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 256
  }'

Ключ — в кабинете. Список моделей IRI: каталог (фильтры Free / Cheap / Balanced / Flagship). У каждой curated-модели — отдельная SEO-страница с ценой и примером.

Каталог моделей — справочник, не касса

На hub /gateway/models/ — полный world-catalog: цены в ₽, контекст, провайдер. Это справочник рынка: что доступно через ключ, смотрите в кабинете и GET /v1/models. Страницы лабораторий (Anthropic, OpenAI, DeepSeek…) и IRI-моделей — для SEO и выбора модели до интеграции.

Curated-линейка в API расширяется по roadmap: sync-скрипт тянет cheap/free модели OpenRouter, admin endpoint POST /admin/reload-catalog обновляет каталог без рестарта.

---

Gateway в стеке IRI Lab

Gateway — не отдельный продукт «ради API». Это инфраструктурный слой Intelligence Runtime: AIOS и AI-BOS сами ходят в модели через шлюз; Agent Studio и Verstak получают единый контракт.

Runtime без моделей бесполезен. Модели без runtime — игрушка. Gateway закрывает нижний уровень стека: доступ к интelligence с предсказуемой экономикой.