> ## 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 は、あらゆる Agent にすべてのモデルを使えるようにします。プロバイダーは一度追加するだけで——DeepSeek、Kimi、GLM、Qwen、OpenRouter、Ollama、あるいはすでに契約している Claude や ChatGPT のサブスクリプション——あとは Codex、Claude Code、Gemini CLI、または任意の Agent でワンクリックで選んで使えます。

各 Agent はモデルをそれぞれ独自の設定ファイルに記述しており、形式はまちまちで、key と base URL も別々に管理されています。お金を払って契約したサブスクリプションは、一つの Agent でしか使えません。magpie はこれらを一つのアプリとローカルゲートウェイにまとめます：

* 任意の Agent で任意のモデルを、一つの表から選択。magpie は Agent 設定のうち変更すべきたった一つのキーだけを書き換えます。
* 一つの provider がどこでも使える：API key、ローカルモデル、あるいはログイン中の Claude、ChatGPT、Copilot、Gemini、Grok のサブスクリプション。
* クォータを使い切っても途切れない：同じプロバイダーの次のアカウントへ自動的に切り替わり、ルーティンググループがあれば別のモデルやプロバイダーへも切り替えられるため、Agent にはエラーが見えません。アカウントが一つだけでルーティンググループを設定していない場合は切り替え先がなく、エラーがそのまま Agent に返されます。
* キーは PC の外に出ない：設定 → プライバシー でマスキングを有効にすると（デフォルトはオフ）、プロンプト内のキー、パスワード、メールアドレスは、リクエストが PC を離れる前にローカルでマスキングされ、レスポンスの段階で元の値に戻されます。

複数の Agent、複数の provider、あるいは複数のアカウントを使っているなら、magpie はまさにうってつけです。一つの Agent しか使わず、その純正のサブスクリプションだけで十分というなら、magpie は必要ありません。

macOS、Windows、Linux に対応（メニューバーアプリ、ウィンドウ、TUI、Web インターフェース、CLI）しており、Docker や Termux 上でも動作します。

## インターフェースAIをMagpieに接続するには？

### API Key の取得

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. 「コピー」をクリックして生成された Key を記録します。コンソールでは再度表示できないため、後で使用できるよう Key を大切に保管してください。

### インターフェースAIをMagpieに接続する

1. プロバイダーにカスタムプロバイダーを追加します

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

2. 先ほどコピーした API Key を入力し、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.