Cherry Studio で Wokey API を使う

1. 1

   プロバイダーを追加する

   Settings → Model Provider を開き、一覧の下部にある + Add Provider をクリックして、Provider Name を Wokey にします。古いバージョンではプロバイダーの種類も尋ねられるので、OpenAI を選んでください。

2. 2

   アドレスとキーを入力する

   エンドポイントの設定で OpenAI に /v1 なしの https://api.wokey.ai を設定し、Wokey の API キーを貼り付けて Add をクリックします。欄の下に、最終的なリクエストパスのプレビューが表示されます。

3. 3

   モデルを追加する

   Sync models をクリックしてモデル一覧を取得するか、その横の + をクリックしてモデル ID を手動で入力します（例：claude-opus-5-5）。

4. 4

   確認して使う

   API キーの右にある Model Check をクリックし、プロバイダーページ右上の有効化スイッチがオンになっていることを確認します。その後、チャット画面上部の Wokey の下からモデルを選びます。

Provider name: Wokey
OpenAI endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model ID: claude-opus-5-5

設定場所: Settings → Model Provider → Add Provider

Cherry Studio はデフォルトで 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": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Cherry Studio の API アドレスに /v1 は必要ですか？

不要です。https://api.wokey.ai を指定してください。Cherry Studio は /v1/chat/completions を自動で付け足し、入力欄の下に最終的なリクエストパスのプレビューを表示するので、保存前に確認できます。

OpenAI と Anthropic、どちらのエンドポイントを入力しますか？

Chat Completions でモデルを呼び出すには OpenAI エンドポイントだけで十分です。Claude モデルをネイティブの Anthropic Messages 形式で送るには、同じプロバイダーの Anthropic エンドポイントにも https://api.wokey.ai を設定してください。古いバージョンにはエンドポイント設定の代わりにプロバイダータイプがあるので、OpenAI を選んでください。

モデル一覧が空なのはなぜですか？

新しいプロバイダーには最初モデルがありません。Sync models をクリックして Wokey から一覧を取得するか、その横の + をクリックしてモデル ID（例：claude-opus-5-5）を手動で入力してください。

Model Check で 401 が返る場合は？

API キー欄にはキーだけを貼り付け、Bearer プレフィックス、スペース、改行を含めないでください。そのうえで、キーが削除または一時停止されていないこと、アカウントに残高があることを確認してください。