外观
聊天客户端接入
多数支持“自定义 OpenAI 接口”或“OpenAI Compatible”的聊天客户端，只需要 Base URL、API Key 和模型 ID 三项配置。不同客户端拼接 /v1 的方式不同，保存前需要先确认它要求的是服务根地址还是 API Base URL。
适用场景
- 在桌面或移动聊天客户端中使用 FlashCoding.AI。
- 客户端支持自定义 OpenAI 兼容服务商、接口地址或模型。
- 已填写密钥但遇到
404、空模型列表或重复/v1/v1。
本页是通用配置方法。若客户端只允许使用内置服务商、不支持自定义 Base URL 或模型 ID，则无法直接按本页接入。
前置条件
开始前准备好：
- 从 FlashCoding.AI 控制台创建的 API Key。下文用
sk-your-key占位。 - 从控制台复制的完整模型 ID。下文用
your-model-id占位。 - 一个支持 OpenAI 兼容接口和自定义 Base URL 的聊天客户端。
- 当前密钥、分组和模型支持客户端采用的 OpenAI 兼容接口。
留意客户端如何保存密钥
优先使用可信、持续维护且能在本地安全保存密钥的客户端。不要把 API Key 输入来源不明的网页、浏览器扩展或共享设备。
操作步骤
1. 新建 OpenAI 兼容服务商
在客户端设置中找到类似“模型服务”“Provider”“自定义 API”或“OpenAI Compatible”的入口。新建一项配置，不要直接修改仍在使用的其他服务商配置。
名称可以自定义为 FlashCoding.AI。协议或服务商类型应选择 OpenAI 兼容，而不是 Anthropic 或 Gemini 原生协议。
2. 填写三项核心配置
| 配置项 | 建议值 | 说明 |
|---|---|---|
| Base URL / API Host | https://flashcoding.ai/v1 | 大多数 OpenAI 兼容客户端使用此值 |
| API Key | sk-your-key | 替换为控制台创建的真实密钥 |
| Model / Model ID | your-model-id | 从控制台复制完整模型 ID |
模型 ID 如果允许手动输入，应直接粘贴控制台中的值。客户端内置的模型下拉列表可能不是当前账户实际可用的列表。
3. 判断客户端是否自动补 /v1
有些客户端会在你填写的地址后自动追加 /v1。应根据其字段说明、预览地址或调试日志选择：
- 客户端要求 API Base URL，并在其后追加
/chat/completions：填写https://flashcoding.ai/v1。 - 客户端明确说明会自动追加
/v1：填写https://flashcoding.ai。 - 客户端要求完整接口地址：填写
https://flashcoding.ai/v1/chat/completions，但仅在字段明确写着 Endpoint 时使用。
最终聊天请求应到达：
text
https://flashcoding.ai/v1/chat/completions1
不要让地址变成 https://flashcoding.ai/v1/v1/chat/completions，也不要把完整接口路径填入普通 Base URL 后再被客户端追加一次。
4. 保存并新建测试对话
保存服务商配置，将当前模型切换为刚才填写的 your-model-id，然后新建一个空白对话并发送：
text
请只回复：聊天客户端连接成功1
首次请求关闭联网搜索、插件、知识库、图片和工具调用等附加能力。基础聊天成功后再逐项开启，便于判断是哪项功能不兼容。
成功验证
接入成功时应满足：
- 客户端能显示模型返回的文本，没有 HTML 错误页或登录页。
- 最终请求 URL 中只有一个
/v1，并进入/chat/completions或客户端明确支持的 OpenAI 接口。 - 会话当前模型是从控制台复制的完整模型 ID。
- FlashCoding.AI 控制台的使用记录中能找到对应时间和模型的请求。
若客户端提供“测试连接”按钮，它只能作为初步检查。仍应发送一次真实对话，并到控制台核对记录。
常见错误
404 Not Found
先查看最终请求 URL。出现 /v1/v1/ 时，说明客户端已经自动补 /v1，应把 Base URL 改为 https://flashcoding.ai；缺少 /v1 时，则改为 https://flashcoding.ai/v1。
401 Unauthorized
重新粘贴 API Key，确认没有空格或换行。API Key 字段只填写密钥本身，不要手动加 Bearer ；兼容客户端通常会在请求头中自动添加它。Base URL 字段不能填写密钥，API Key 字段也不要包含引号。
找不到模型或模型列表为空
若客户端允许手动添加模型，直接填写控制台中的完整模型 ID。模型列表接口能否展示所有可用项取决于客户端实现；列表为空不一定代表聊天接口不可用。
模型不存在或无权限
检查模型 ID 是否完整，以及当前密钥和分组是否允许访问它。不要从客户端的预设列表猜测，也不要沿用其他账户的模型名。
返回 HTML、登录页或证书错误
确认地址以 https://flashcoding.ai 开头，没有填写控制台网页路径。若设备使用代理、抓包证书或企业网络，先在可信网络中用最小配置复测。
普通对话成功，但插件或图片功能失败
这说明基础连接已经完成，问题更可能来自额外能力、接口路径或模型支持范围。关闭附加功能后逐项开启，并以控制台对目标模型的协议说明为准。
客户端把密钥同步到云端
检查客户端的同步和备份选项。无法确认密钥存储方式时，不要继续使用该客户端；停用已经输入的密钥，并创建一把用途独立的新密钥。
下一步
- 想确认 OpenAI 请求格式：阅读 OpenAI 兼容接口。
- 不确定客户端是否自动补路径：查看 Base URL 与协议。
- 需要定位状态码和响应正文：继续状态码与错误或故障排查。