外观
Base URL 与协议
“Base URL 填什么”取决于客户端是否会自动追加版本号和接口路径。相同的 FlashCoding.AI 服务，在原始 HTTP 请求与不同客户端中可能需要填写不同形式。
适用场景
- 客户端要求填写 Base URL、Host 或 Endpoint。
- 遇到
404、405，或响应内容是 HTML。 - 请求地址中出现重复的
/v1/v1/。 - 需要在 OpenAI、Anthropic 与 Gemini 协议之间选择。
前置条件
开始前先确认：
- 客户端使用哪一种协议，而不只是它支持哪家模型。
- 客户端要求的是服务根地址，还是已经包含版本号的 API Base URL。
- 控制台中当前模型所属分组允许哪种协议。
平台根地址为：
text
https://flashcoding.ai1
OpenAI 兼容 API Base URL 通常为：
text
https://flashcoding.ai/v11
地址速查
| 使用方式 | 建议填写或请求的地址 | 说明 |
|---|---|---|
| 原始 OpenAI Chat 请求 | https://flashcoding.ai/v1/chat/completions | 完整接口路径 |
| 原始 Responses 请求 | https://flashcoding.ai/v1/responses | 完整接口路径 |
| 获取模型列表 | https://flashcoding.ai/v1/models | 用于鉴权和模型标识检查 |
| OpenAI 兼容 SDK / 客户端 | https://flashcoding.ai/v1 | SDK 通常再追加具体接口 |
| Claude Code | https://flashcoding.ai | ANTHROPIC_BASE_URL 使用服务根地址 |
| Gemini CLI | https://flashcoding.ai | GOOGLE_GEMINI_BASE_URL 使用服务根地址 |
| Codex 自定义 provider | https://flashcoding.ai/v1 | 配合 Responses 协议 |
客户端生成配置优先
如果控制台“使用密钥”弹窗为你的分组生成了配置，优先使用弹窗中的地址和字段。客户端版本变化时，生成配置通常比旧教程更接近当前实现。
操作步骤
1. 判断客户端如何拼接路径
查看字段名称和示例：
- 字段写作
Base URL，示例以/v1结尾时，通常填写https://flashcoding.ai/v1。 - 字段写作
Host，或客户端文档说明会自行追加/v1/...时，通常填写https://flashcoding.ai。 - 直接使用 curl、Postman 或 HTTP 库时，填写完整接口路径。
如果无法确定，打开客户端调试日志或代理记录，查看最终请求 URL，而不是反复猜测。
2. 选择协议
OpenAI 兼容协议
常见接口包括：
text
POST /v1/chat/completions
POST /v1/responses
GET /v1/models1
2
3
2
3
不同接口的请求体不同。不能只把 /chat/completions 改成 /responses 而沿用原 JSON；具体格式见 OpenAI 兼容接口。
Anthropic Messages 协议
Claude Code 等工具通常从服务根地址开始，自行请求 Messages 路径。按照 Claude Code 接入教程设置 ANTHROPIC_BASE_URL，不要额外手动拼接 /v1/messages。
Gemini 原生协议
Gemini CLI 会根据配置和模型自行构造请求路径。按照 Gemini CLI 接入教程设置 GOOGLE_GEMINI_BASE_URL，原始 HTTP 格式见 Gemini 原生接口。
3. 避免重复版本路径
假设应用会请求 ${baseURL}/chat/completions：
text
正确：https://flashcoding.ai/v1 + /chat/completions
结果：https://flashcoding.ai/v1/chat/completions1
2
2
若应用会请求 ${baseURL}/v1/chat/completions，Base URL 就不应再包含 /v1：
text
正确：https://flashcoding.ai + /v1/chat/completions
结果：https://flashcoding.ai/v1/chat/completions1
2
2
成功验证
先验证 OpenAI 兼容入口和 API Key：
bash
curl -i https://flashcoding.ai/v1/models \
-H "Authorization: Bearer sk-your-key"1
2
2
检查三点：
- 最终 URL 中只有一个
/v1。 - 响应是 JSON，而不是网站首页 HTML。
- 状态码与错误正文一致；例如
401表示请求已到达 API，但鉴权未通过。
然后用目标协议发送一次最小模型请求，并在控制台使用记录中核对时间、模型与状态。
常见错误
/v1/v1/ 重复
客户端已经自动追加 /v1，而你填写的 Base URL 也包含 /v1。删除其中一处，具体保留哪一处由客户端的拼接规则决定。
只填写 https://flashcoding.ai
对要求 OpenAI API Base URL 的 SDK，这可能导致请求落到 /chat/completions 而不是 /v1/chat/completions。改为 https://flashcoding.ai/v1。
把完整接口路径填进 Base URL
若把 /v1/chat/completions 填入 Base URL，客户端可能继续追加一次 /chat/completions。Base URL 字段通常只填到 /v1 或域名根路径。
收到 HTML 而不是 JSON
通常表示请求到达了网页路由、登录页或中间代理错误页。记录状态码和最终 URL，确认请求使用 HTTPS 且路径正确。
404 与模型错误混淆
404 多半先检查路径；模型 ID 无效通常会返回结构化 JSON 错误。排查时保留响应正文，不要只看客户端的一句摘要。
随意启用 WebSocket
只有控制台生成配置或客户端文档明确说明支持时才启用 WebSocket。普通 HTTP/SSE 配置可用时，不要为了“更快”自行添加 WebSocket 开关。
下一步
- 已确认 OpenAI 地址：继续 OpenAI 兼容接口。
- 正在配置工具：选择 Claude Code、Codex、Gemini CLI 或聊天客户端。
- 仍然失败：按故障排查记录最终 URL、状态码和响应正文。