pi で Wokey API を使う

1. 1

   API キーを export する

   pi を起動するターミナルで export WOKEY_API_KEY="YOUR_API_KEY" を実行するか、~/.zshrc に追加します。

2. 2

   models.json を書く

   以下の内容を ~/.pi/agent/models.json に保存します。ファイルにほかのプロバイダーが既にある場合は、providers の下に wokey のエントリだけを追加してください。

3. 3

   モデルを選ぶ

   pi を起動して /model と入力し、wokey の下のモデルを選びます。

{
  "providers": {
    "wokey": {
      "baseUrl": "https://api.wokey.ai",
      "api": "anthropic-messages",
      "apiKey": "$WOKEY_API_KEY",
      "models": [
        { "id": "claude-opus-5-5", "reasoning": true, "input": ["text", "image"] }
      ]
    }
  }
}

設定場所: ~/.pi/agent/models.json

pi はデフォルトで Anthropic Messages 形式を使います。このリクエストで 200 が返れば、API キーと Base URL は正しく設定されています。送信前に YOUR_API_KEY をご自身のキーに置き換えてください。

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

pi の baseUrl に /v1 は必要ですか？

api フィールドによります。anthropic-messages の場合は /v1 なしの https://api.wokey.ai、openai-completions または openai-responses の場合は https://api.wokey.ai/v1 を指定してください。

/model に Wokey のモデルが表示されないのはなぜですか？

pi は API キーを解決できないとカスタムモデルを一覧に表示しません。apiKey が $WOKEY_API_KEY の場合は、pi を起動するのと同じターミナルで export WOKEY_API_KEY を実行し、models.json が有効な JSON かどうかを確認してください。/model は開くたびにこのファイルを読み直します。

pi で Wokey のモデルに画像を送るには？

pi のカスタムモデルは、デフォルトではテキスト入力のみを宣言します。画像に対応するモデルに "input": ["text", "image"] を追加して、画像入力を受け付けることを宣言してください。

コンテキストウィンドウと最大出力を変更する必要はありますか？

指定しない場合、pi は contextWindow 128000、maxTokens 16384 とみなします。モデルのウィンドウがそれより大きい場合は、モデルエントリの contextWindow と maxTokens をモデルページの値に合わせて設定してください。

API キーをファイルに書かずに済ませられますか？

はい。apiKey には $NAME 形式の環境変数や、コマンドの出力からキーを読み取る !command 形式を指定できます。