クライアント/Claude Desktop

Claude Desktop で Wokey API を使う

Wokey の API キーを取得し、Claude Desktop の Base URL を Wokey に向けてから、curl リクエスト 1 回で接続を確認します。

更新日

このページの内容expand_more

API キーと Base URL を用意するlink

どのクライアントも、同じ Wokey API キーと同じ Base URL を使います。

API キーを作成する

ログインして API ページでプラットフォームのキーを作成します。同じアカウントのキーは残高を共有します。

API キーを作成key

Wokey の Base URL を使う

クライアントの Base URL にはゲートウェイのドメインを設定します。/v1 を付けるかどうかは以下の設定を参照してください。

クライアントを設定するlink

Claude Desktop は最新版のアプリが必要で、デベロッパーモードでサードパーティ推論を設定します。左の手順に従ってください。

  1. 1

    最新の Claude Desktop をインストールする

    まず最新版に更新してください。古いバージョンには Developer mode やサードパーティ推論の設定がない場合があります。

  2. 2

    ログインせずにアプリを開く

    Claude Desktop を起動し、初期設定の間はログアウトしたままにします。

  3. 3

    Developer mode を有効にする

    右上のメニューを開き、Help → Troubleshooting → Enable developer mode を選びます。

  4. 4

    サードパーティ推論の設定を開く

    Developer mode を有効にしたら、Claude メニューを開いて Developer → Configure third-party inference を選びます。

  5. 5

    Wokey の接続情報を入力する

    Connection を Gateway に、Credential kind を Static API key に設定します。Wokey の Base URL と Wokey の API キーを入力してください。

  6. 6

    適用して再起動する

    Apply Changes をクリックし、続けて Save & Restart をクリックします。再起動後は Anthropic アカウントにログインせずに Claude Desktop を使ってください。ログインすると、リクエストは Anthropic に送られます。

Claude Desktop
Connection: Gateway
Credential kind: Static API key
URL: https://api.wokey.ai
API key: YOUR_API_KEY

Apply: Apply Changes → Save & Restart

API 形式と Base URLlink

同じクライアントでも API 形式を切り替えると、Base URL の末尾に /v1 を付けるかどうかが変わることがあります。

形式Base URL用途
Anthropic Messageshttps://api.wokey.aiClaude モデル

設定場所: メニュー Developer → Configure third-party inference

curl で確認するlink

クライアントがエラーを出す場合は、まず curl で API キーと Base URL の問題ではないことを確認します。

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

cURL
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" }
    ]
  }'

エラーとトラブルシューティングlink

まず認証、残高、レート制限、モデルの利用可否、アップストリームのタイムアウトのどれかを切り分けます。

401

invalid api key

キーがない、入力ミスがある、削除されている、または Authorization と x-api-key ヘッダーの内容が食い違っています。

402

insufficient balance

アカウントの残高が不足しています。リクエストを続ける前にチャージしてください。

403

model_denylisted / account_restricted

違反が繰り返されたため、そのモデル、またはアカウントのすべてのモデルへの呼び出しが停止されています。「違反処理手数料と制限」を参照してください。

403

request_blocked

このリクエストはアップストリームに届く前にブロックされ、課金されていません。たとえば、モデルが直前に拒否したリクエストを変更せずに再送した場合や、停止中のエンドユーザー（X-End-User-Id）の場合です。エラーメッセージに何がブロックされたかが示されるので、その内容に沿ってリクエストを変更するか、時間をおいて再試行してください。ほかのリクエストには影響しません。

429

rate limited

リクエストの頻度が高すぎます。時間をおいて再試行するか、同時実行数を減らしてください。特定のモデル、または特定のエンドユーザー（X-End-User-Id）だけが 429 を返し続ける場合は、違反後の一時的な制限の可能性があります。

499

client disconnected

レスポンスの完了前にクライアントが接続を閉じました（コード downstream_aborted）。デフォルトでは無料です。過去 24 時間にアカウントのクライアント切断が 50 回以上あり、それがリクエストの 10% 以上を占めると、以降の切断されたリクエストはアップストリームが報告した使用量で課金されます。対象は、キャッシュの読み書きを含む処理済みの入力と、アップストリームが計上した場合に限り出力です。アップストリームが使用量を報告する前に切断された場合は無料のままです。課金が始まるとアカウントに通知され、切断率が通常に戻ると 1 時間以内に課金は自動的に停止します。よくある原因は、クライアントやプロキシのタイムアウトが短すぎることや、プログラムが完了前にリクエストをキャンセルしていることです。

502

upstream unavailable

アップストリームのモデルサービスが一時的に利用できません。モデルを切り替えるか、時間をおいて再試行してください。

504

upstream timeout

アップストリームのレスポンスがタイムアウトしました。コンテキストを短くするか、max_tokens を減らすか、再試行してください。

529

upstream overloaded

アップストリームのモデルが一時的に過負荷になっており、Wokey はほかの経路での再試行を済ませています（コード upstream_overloaded）。残高とは関係ありません。少し待ってから再試行するか、モデルを切り替えてください。

よくある質問link

Claude Desktop の URL に /v1 は必要ですか？
不要です。Connection に Gateway を選び、URL に https://api.wokey.ai を指定し、Credential kind に Static API key を選んで、Wokey の API キーを入力してください。
Configure third-party inference が見つからない場合は？
Claude Desktop を最新バージョンに更新してから、Help → Troubleshooting → Enable developer mode を開いてください。Configure third-party inference は、開発者モードを有効にした後でのみ Developer メニューに表示されます。
設定後も Anthropic アカウントにログインする必要がありますか？
不要です。Apply Changes と Save & Restart の後、ログインせずにそのまま使い始めてください。Anthropic アカウントにログインすると、リクエストは Wokey ではなく Anthropic に送られます。

設定・エラーガイドlink