> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> JieKou AI model APIs are OpenAI-compatible. Base URL for users in mainland China (direct, no VPN): https://api.highwayapi.ai/openai; elsewhere: https://api.jiekou.ai/openai. Anthropic-compatible base URL: https://api.highwayapi.ai/anthropic or https://api.jiekou.ai/anthropic.
> Authenticate with `Authorization: Bearer <API_KEY>`; with Anthropic SDKs or Claude Code, pass the same key as `ANTHROPIC_AUTH_TOKEN`. Users create keys at https://jiekou.ai/settings/key-management. Never print or hardcode a real key.
> Get current model IDs from GET https://api.jiekou.ai/openai/v1/models instead of reusing model names from memory.

# Magpie

## Что такое Magpie?

magpie даёт каждому агенту доступ к любой модели. Провайдеров достаточно добавить один раз — DeepSeek, Kimi, GLM, Qwen, OpenRouter, Ollama или уже оплаченные подписки Claude и ChatGPT — а затем выбирать их в один клик в Codex, Claude Code, Gemini CLI или любом другом агенте.

Каждый агент хранит модели в собственном конфигурационном файле, у каждого свой формат, а ключи и base URL настраиваются по отдельности. Оплаченная подписка работает только в одном агенте. magpie собирает всё это в одном приложении и одном локальном шлюзе:

* Любой агент может работать с любой моделью — выбор в одной таблице. magpie меняет только тот единственный ключ в конфигурации агента, который нужно.
* Один провайдер доступен везде: API-ключ, локальные модели или подписки Claude, ChatGPT, Copilot, Gemini, Grok, в которые вы уже вошли.
* Квота закончилась — работа не прерывается: автоматически подключается следующий аккаунт того же провайдера, а группа маршрутизации может переключиться на другую модель или провайдера, и агент не увидит ошибку. Ошибка вернётся агенту в исходном виде только если у вас один аккаунт и не создана группа маршрутизации — тогда переключаться просто не на что.
* Ключи не покидают ваш компьютер: после включения маскировки в разделе «Настройки → Конфиденциальность» (по умолчанию отключена) ключи, пароли и адреса электронной почты в промптах маскируются локально до того, как запрос покинет компьютер, а в ответе подставляются обратно.

Если вы используете больше одного агента, больше одного провайдера или больше одного аккаунта — magpie вам подойдёт. Если вы работаете только с одним агентом, используете только его собственную подписку и вам её хватает, magpie не нужен.

Поддерживаются macOS, Windows и Linux (приложение в строке меню, окно, TUI, веб-интерфейс и CLI), а также Docker и Termux.

## Как подключить Interface AI к Magpie?

### Получение API-ключа

1. Войдите на официальный сайт jiekou.ai и зарегистрируйтесь.

2. Перейдите в панель управления, нажмите «Мой профиль» в правом верхнем углу и выберите в выпадающем списке «Управление API-ключами».

   ![](https://mintcdn.com/jiekou/f-T_E3hNj8sGYUsR/images/magpie-01.png?fit=max\&auto=format\&n=f-T_E3hNj8sGYUsR\&q=85\&s=c123fc8d8326ed7b03e6275713012eb5)

3. Нажмите «Создать» и введите название ключа. Рекомендуется указывать легко узнаваемое имя, чтобы в дальнейшем различать в консоли ключи для разных задач.

   ![](https://mintcdn.com/jiekou/f-T_E3hNj8sGYUsR/images/magpie-02.png?fit=max\&auto=format\&n=f-T_E3hNj8sGYUsR\&q=85\&s=6e87360fa491250e85699d119031cbf4)

4. Нажмите «Копировать» и сохраните сгенерированный ключ. Повторно посмотреть его в консоли будет нельзя, поэтому храните ключ в надёжном месте для дальнейшего использования.

### Подключение Interface AI к Magpie

1. Добавьте пользовательского провайдера в разделе провайдеров

   ![](https://mintcdn.com/jiekou/eY20tqhq6niA3Adp/images/magpie-03.png?fit=max\&auto=format\&n=eY20tqhq6niA3Adp\&q=85\&s=fb3087b909f1f06080f6ca4813ab44ef)

2. Вставьте только что скопированный API-ключ, укажите URL и выберите формат API (API Endpoint), подходящий для моделей, которые вы хотите вызывать

* URL для прямого подключения (Китай): [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai)
* Международный URL: [https://api.jiekou.ai/openai](https://api.jiekou.ai/openai)

  ![](https://mintcdn.com/jiekou/eY20tqhq6niA3Adp/images/magpie-04.png?fit=max\&auto=format\&n=eY20tqhq6niA3Adp\&q=85\&s=8ffe91b383d1f6b8e217d0c306c53806)

3. Введите ID модели или нажмите «Получить модели», чтобы посмотреть список моделей, затем нажмите «Добавить» для подключения


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.