Windsurf 接入教程

Windsurf 是 Codeium 推出的新一代 AI 编程编辑器。

前置条件

1. 前往 Lumina 控制台 获取 API Key
2. 下载安装 Windsurf

配置步骤

1. 打开 Settings → AI Models
2. 选择 Custom Model / OpenAI Compatible：
   • Base URL: https://us.api.aiflow321.cn/v1（Anthropic 接口则 https://us.api.aiflow321.cn）
   • API Key: sk-你的Key
3. 测试并保存，在 Chat / Agent Mode 发条指令验证。

---

常见问题与异常处理 (FAQ)

错误	原因	解决方案
401 Unauthorized	API Key 错误或为空	前往 Lumina 控制台 重新获取密钥
404 Not Found	接口地址格式错误	确认 Base URL 是否正确（大部分需要 https://us.api.aiflow321.cn/v1）
429 Too Many Requests	请求频繁或额度耗尽	等待冷却或前往Lumina 控制台检查额度
连接超时 / Network Error	网络或代理冲突	检查代理/VPN，确认 URL 无空格
SSE 流式输出乱码	端点类型不匹配	将端点类型改为 OpenAI 或 OpenAI-Response

提示: 如果依然无法解决，请携带完整报错截图联系 Lumina 支持。