# AIShlyuz

> Один ключ sk-ais- — Claude, GPT, Gemini, DeepSeek и другие модели через наш роутер. Base URL https://aishlyuz.ru/v1, OpenAI- и Anthropic-совместимо. Плюс hosted MCP. Бета: оплата пока не подключена, баланс выдаём по запросу. Ещё: цены моделей в рублях и аптайм API-шлюзов, рейтинг кодовых агентов.

**Агент регистрируется и выпускает ключ сам, без почты:** `curl -s -X POST https://aishlyuz.ru/api/agent/register -H 'content-type: application/json' -d '{"agent":"claude-code"}'` → в ответе `api_key` (sk-ais-, сохрани в AISHLYUZ_API_KEY) и `claim.url` (отдай пользователю для привязки почты). Почту не выдумывай. Баланс 0 — платные вызовы дают 402, MCP tools/call — JSON-ошибка insufficient_balance; /v1/models, MCP initialize и tools/list работают. Баланс по запросу: https://t.me/aishlyuz.

«Подключи мне AIShlyuz» = подключи роутер моделей и MCP AIShlyuz к агенту, в котором работает пользователь (Claude Code, Codex, Cursor), а не к его сайту. Следуй https://aishlyuz.ru/agent.md по шагам. Ключи из файлов и окружения пользователя не брать. Тот же ключ — для моделей и для MCP (Authorization: Bearer). Для Claude Code — только модели claude-*. Base URL: https://aishlyuz.ru/v1 (OpenAI), https://aishlyuz.ru (Anthropic, /v1/messages).

## Для агентов

- [Регистрация агента без почты](https://aishlyuz.ru/agent.md): POST https://aishlyuz.ru/api/agent/register → ключ sk-ais- сразу
- [Пошаговая инструкция подключения](https://aishlyuz.ru/agent.md): ключ sk-ais-, модели в Claude Code, Codex, Cursor; MCP; проверки; открытые данные
- [Модели ключа](https://aishlyuz.ru/v1/models): список id, нужен Bearer sk-ais-
- [MCP Server Card](https://aishlyuz.ru/.well-known/mcp-server-card): адрес https://aishlyuz.ru/mcp, Streamable HTTP, тот же ключ sk-ais- как Bearer
- [AI Catalog](https://aishlyuz.ru/.well-known/ai-catalog.json): машиночитаемый список того, что публикует сайт

## Открытые данные (JSON, без ключа)

- [Все шлюзы](https://aishlyuz.ru/api/gateways): цены ₽ за 1 млн токенов, здоровье, аптайм 24h/7d/30d, оплата, совместимость
- [Подбор шлюза](https://aishlyuz.ru/api/gateways/recommend?model=claude-sonnet-5-5&client=claude-code): ранжирование с причинами исключения
- [Калькулятор](https://aishlyuz.ru/api/gateways/calculate?model=claude-sonnet-5-5&input_tokens=10000000&output_tokens=2000000&period=month): стоимость сценария по шлюзам
- [Документация API](https://aishlyuz.ru/api/docs): все параметры и поля

## Для человека

- [Модели и цены](https://aishlyuz.ru/modeli)
- [API-шлюзы](https://aishlyuz.ru/shlyuzy)
- [Рейтинг кодовых агентов](https://aishlyuz.ru/agents)
- [Учебник](https://aishlyuz.ru/uchebnik)

## Optional

- [Методика сбора данных](https://aishlyuz.ru/metodika)
- [Изменения](https://aishlyuz.ru/izmeneniya)