Windsurf

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 URLCopy anchor link

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 detailsCopy anchor link

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

TestCopy anchor link

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

NotesCopy anchor link

• 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