クライアント/Magpie
Magpie で Wokey API を使う
Wokey の API キーを取得し、Magpie の Base URL を Wokey に向けてから、curl リクエスト 1 回で接続を確認します。
更新日
API キーと Base URL を用意するlink
どのクライアントも、同じ Wokey API キーと同じ Base URL を使います。
Wokey の Base URL を使う
クライアントの Base URL にはゲートウェイのドメインを設定します。/v1 を付けるかどうかは以下の設定を参照してください。
クライアントを設定するlink
Magpie はお使いのマシン上で動くモデルゲートウェイです。Wokey をプロバイダーとして追加すると、マシン上のすべてのエージェントが Magpie 経由で Wokey のモデルを呼び出せます。Magpie は API 形式ごとに 1 つのアドレスを保存し、コマンド 1 つで 3 つすべてを設定できます。
- 1
プロバイダーを追加する
以下の magpie provider add コマンドを、YOUR_API_KEY を Wokey の API キーに置き換えて実行します。url と responses には https://api.wokey.ai/v1、anthropic には /v1 なしの https://api.wokey.ai を指定します。models 引数を省略すると、Magpie は Wokey からモデル一覧を読み込みます。
- 2
またはインポートリンクを使う
Magpie 0.1.8 以降では、https://usemagpie.ai/import#name=Wokey&chat=https://api.wokey.ai/v1&anthropic=https://api.wokey.ai を開き、ダイアログに API キーを貼り付けて確定します。
- 3
エージェントでモデルを選ぶ
モデルは wokey/モデル ID の形で指定します。例:wokey/claude-opus-5-5。
magpie provider add "Wokey" \
url=https://api.wokey.ai/v1 \
responses=https://api.wokey.ai/v1 \
anthropic=https://api.wokey.ai \
key=YOUR_API_KEYAPI 形式と Base URLlink
同じクライアントでも API 形式を切り替えると、Base URL の末尾に /v1 を付けるかどうかが変わることがあります。
| 形式 | Base URL | 用途 |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai/v1 | DeepSeek、GLM、Kimi などのモデル |
| OpenAI Responses | https://api.wokey.ai/v1 | GPT モデル |
| Anthropic Messages | https://api.wokey.ai | Claude モデル |
設定場所: magpie provider add またはインポートリンク(ファイル ~/.config/magpie/providers.json)
curl で確認するlink
クライアントがエラーを出す場合は、まず curl で API キーと Base URL の問題ではないことを確認します。
Magpie はデフォルトで OpenAI Chat Completions 形式を使います。このリクエストで 200 が返れば、API キーと Base URL は正しく設定されています。送信前に YOUR_API_KEY をご自身のキーに置き換えてください。
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'エラーとトラブルシューティングlink
まず認証、残高、レート制限、モデルの利用可否、アップストリームのタイムアウトのどれかを切り分けます。
invalid api key
キーがない、入力ミスがある、削除されている、または Authorization と x-api-key ヘッダーの内容が食い違っています。
insufficient balance
アカウントの残高が不足しています。リクエストを続ける前にチャージしてください。
model_denylisted / account_restricted
違反が繰り返されたため、そのモデル、またはアカウントのすべてのモデルへの呼び出しが停止されています。「違反処理手数料と制限」を参照してください。
request_blocked
このリクエストはアップストリームに届く前にブロックされ、課金されていません。たとえば、モデルが直前に拒否したリクエストを変更せずに再送した場合や、停止中のエンドユーザー(X-End-User-Id)の場合です。エラーメッセージに何がブロックされたかが示されるので、その内容に沿ってリクエストを変更するか、時間をおいて再試行してください。ほかのリクエストには影響しません。
rate limited
リクエストの頻度が高すぎます。時間をおいて再試行するか、同時実行数を減らしてください。特定のモデル、または特定のエンドユーザー(X-End-User-Id)だけが 429 を返し続ける場合は、違反後の一時的な制限の可能性があります。
client disconnected
レスポンスの完了前にクライアントが接続を閉じました(コード downstream_aborted)。デフォルトでは無料です。過去 24 時間にアカウントのクライアント切断が 50 回以上あり、それがリクエストの 10% 以上を占めると、以降の切断されたリクエストはアップストリームが報告した使用量で課金されます。対象は、キャッシュの読み書きを含む処理済みの入力と、アップストリームが計上した場合に限り出力です。アップストリームが使用量を報告する前に切断された場合は無料のままです。課金が始まるとアカウントに通知され、切断率が通常に戻ると 1 時間以内に課金は自動的に停止します。よくある原因は、クライアントやプロキシのタイムアウトが短すぎることや、プログラムが完了前にリクエストをキャンセルしていることです。
upstream unavailable
アップストリームのモデルサービスが一時的に利用できません。モデルを切り替えるか、時間をおいて再試行してください。
upstream timeout
アップストリームのレスポンスがタイムアウトしました。コンテキストを短くするか、max_tokens を減らすか、再試行してください。
upstream overloaded
アップストリームのモデルが一時的に過負荷になっており、Wokey はほかの経路での再試行を済ませています(コード upstream_overloaded)。残高とは関係ありません。少し待ってから再試行するか、モデルを切り替えてください。
よくある質問link
- Magpie の Wokey アドレスに /v1 は必要ですか?
- Magpie は形式ごとにアドレスを保存します。chat と responses には https://api.wokey.ai/v1、anthropic には /v1 なしの https://api.wokey.ai を指定してください。アドレスは https である必要があります。
- インポートリンクを開いても何も起きない場合は?
- インポートリンクには Magpie 0.1.8 以降が必要です。先にアップグレードするか、代わりに magpie provider add コマンドでプロバイダーを追加してください。
- エージェントでモデル名はどう書きますか?
- プロバイダー id/モデル名 の形式で書きます。Wokey という名前のプロバイダーの id は wokey なので、Claude Opus 5.5 は wokey/claude-opus-5-5 になります。
- Wokey の API キーはどこに入力しますか?
- インポートダイアログにキーを貼り付けるか、magpie provider add に key= として渡します。Magpie はキーを ~/.config/magpie/providers.json に保存します。
- キーを含むインポートリンクを共有してもよいですか?
- やめてください。key パラメータは平文なので、リンクを持つ人は誰でもあなたの残高を使えてしまいます。共有する前に key パラメータを削除してください。相手はインポートダイアログで自分のキーを入力します。