# Windsurf

Source: https://docs.aicentos.com/en/clients/windsurf

Language: en

> Enter the aicentos endpoint and API Key in Windsurf once your build supports a custom Base URL

This document explains how to connect to this service in Windsurf using a custom OpenAI-compatible configuration. Windsurf's BYOK and custom model capabilities differ between versions, so two cases are covered here.

## First check whether your version supports a custom Base URL

In Windsurf's model, subscription or AI settings, look for entries like these:

* `Models`
* `BYOK`
* `OpenAI`
* `Custom`
* `Base URL`

If you can only enter an official API Key and there is no editable Base URL, that version usually only supports the official BYOK mode and cannot be pointed at this gateway directly.

## Fill in the custom connection details

If your version offers a custom OpenAI-compatible configuration, fill in:

* Base URL: `https://aicentos.com/v1`
* API Key: your `codex_...` or `sk-...` key
* Model ID: follow the results returned by `GET /v1/models`; if you only want a quick connectivity test, try `gpt-6-astra` first

## Test

After saving the settings, start a new Cascade conversation or coding task and confirm results come back normally.

## Notes

* The Base URL should be `https://aicentos.com/v1`
* Do not write the full `/v1/chat/completions` or `/v1/responses` path
* If the current version only offers official BYOK with no custom Base URL, it cannot connect to this gateway directly
* Windsurf's official models page: `https://docs.windsurf.com/windsurf/models`