AZZ API

Windsurf Integration Tutorial: Customizing Cascade Agent Endpoints

Codeium Windsurf AI IDE integration tutorial: How to configure custom model endpoints and API keys in settings to access Claude, GPT, and Gemini.

1. What is Windsurf?

Windsurf is an AI-first IDE with an integrated Cascade agent that supports custom model endpoints. By pointing it to our gateway, you can access Claude, GPT, and Gemini using a unified API key.

2. Preparation

  1. Log in to the Azztimes console and create an sk-xxxxxx API Key (it will only be displayed once, so please save it).
  2. Identify the model slug you wish to use (e.g., claude-sonnet-5, gpt-5.4, gemini-3.7-flash).
  3. Confirm the gateway address: https://www.relay-api.com.

3. Configuring in Windsurf

Open Settings → Models / API Providers → Add Provider, select the provider type, and enter the following details:

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-your-key
Model    : claude-sonnet-5
(For GPT models, set Base URL to https://www.relay-api.com/v1)
(For Gemini models, set Base URL to https://www.relay-api.com/v1beta)

After saving, select the model within Cascade and press Ctrl+L (or Cmd+L on macOS) to start a conversation.

4. API Endpoint Reference

Model GroupBase URLProtocol
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

Use the corresponding entry from the table above for the Base URL.

5. Troubleshooting

IssueResolution
401 / 403Invalid key, disabled account, or insufficient balance; verify the sk- key and add credit.
404 / Model UnavailableThe model name does not match the platform slug, or the model is not enabled; double-check the model ID.

Security Tip: Never hardcode your API key into public repositories. Create separate keys for different purposes to facilitate usage tracking and quota management.