AZZ API

Windsurf API中継接続ガイド：Cascade エージェントのカスタムエンドポイント設定

Codeium Windsurf AI IDE 接続ガイド：設定でカスタムモデルエンドポイントと API キーを構成し、Claude / GPT / Gemini の各モデルを呼び出す方法。

一、Windsurf とは

Windsurf は AI ファーストの IDE であり、Cascade エージェントが組み込まれており、カスタムモデルエンドポイントの追加をサポートしています。本サイトのゲートウェイを指定することで、統一された API キーを使用して Claude / GPT / Gemini を呼び出すことができます。

二、準備

  1. 極智API（Jizhi API）コンソールにログインし、sk-xxxxxx API キーを作成します（一度しか表示されないため、必ず保存してください）。
  2. 使用するモデルの slug（例：claude-sonnet-5、gpt-5.4、gemini-3.7-flash）を確認します。
  3. ゲートウェイアドレス：https://www.relay-api.com を確認します。

三、Windsurf での設定

Settings → Models / API Providers → Add Provider を開き、プロバイダータイプを選択して以下を入力します：

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-あなたのキー
Model    : claude-sonnet-5
(GPT モデルの場合、Base URL を https://www.relay-api.com/v1 に変更してください)
(Gemini モデルの場合、Base URL を https://www.relay-api.com/v1beta に変更してください)

保存後、Cascade で該当モデルを選択し、Ctrl+L（macOS の場合は Cmd+L）でチャットを呼び出せば完了です。

四、API アドレス対応表

モデルグループ本サイトの入口（Base URL）プロトコル
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

Base URL には上の表の入口を使用してください。

五、トラブルシューティング

現象対処法
401 / 403キーが無効、未有効化、または残高不足です。sk- で始まるキーが正しいか確認し、チャージを行ってください。
404 / モデル利用不可モデル名がプラットフォームの slug と一致していないか、そのモデルが有効化されていません。モデル ID を確認してください。

セキュリティに関するアドバイス：キーを公開リポジトリに記述しないでください。用途ごとに個別のキーを作成することで、統計管理や利用制限が容易になります。