国内接入 AI API：地址配置与网络排查

国内接入 AI API，先核对三个环节

中文网站可以打开、API 地址可以连接、模型请求成功，是三个不同结果。棉花糖 API 的网站与接口使用不同域名，请分别检查；各地区、运营商和时段的可用性以实际请求为准。

1. 分清网站、接口与客户端订阅

API 中转指应用请求经过第三方网关转发至所选上游。棉花糖 API 是独立第三方服务，不是 OpenAI 官方。ChatGPT 等产品的订阅额度与本站 API 账单分别管理，不会因为已有客户端订阅就自动抵扣本站费用。

2. 验证 API 的连接与鉴权

在当前网络中使用模型列表检查，确认地址、Key 与可用模型。国内电信、联通、移动及企业网络的路径可能不同，单一节点成功不能代表全国稳定可用。本页不承诺所有地区免配置直连。

• 网页正常，API 超时：分别核对两个域名的 DNS 与 TLS；检查客户端代理、网络出口和防火墙。
• 返回 401：已收到 HTTP 响应，下一步检查鉴权，不要只反复修改 DNS。
• 返回 404：核对 Base URL 与协议，不要重复拼接 /v1 或填写完整请求路径。
• 返回 429：按错误内容区分限流、并发、配额和余额；参阅报错排查表。

3. 按客户端配置，再核对实际用量

• Codex CLI：config.toml、自定义 Provider 与独立 profile
• Python：OpenAI SDK 自定义 base_url
• Cursor：API Key 与接口地址
• Cherry Studio：供应商与模型配置

用一条简短请求测试目标模型，再在控制台核对结果与消耗。接入前查看价格、模型目录和账号分组权限；公开注册是否开放，以登录入口当前提示为准。

API Key 应放在哪里

放在服务端环境变量或可信客户端的密钥设置中，不要放进公开前端代码、Git 仓库、共享截图或群聊。业务请求经过第三方网关，接入前应核对自己的数据与权限要求。