客户端配置

适用于支持自定义 API 地址的聊天工具。不同版本字段名称可能不同，以下以协议和最终请求路径为判断依据。

通用配置表

配置项	内容
服务商名称	自定义名称，例如 COCO API
协议类型	根据模型选择 OpenAI 兼容或 Claude Messages
API 根地址	https://api.cocoapi.top
带版本的 Base URL	https://api.cocoapi.top/v1，仅用于需要该格式的字段
API Key	本站 API 密钥，不是账号密码
模型	从本站模型广场复制的精确标识

Cherry Studio 等聊天工具

1. 在设置中添加自定义服务商或兼容服务商。
2. 选择与模型匹配的协议，填写本站地址与独立密钥。
3. 若有「获取模型列表」功能，可尝试获取；也可手动添加模型名称。
4. 选中模型，用一句短文本测试，再到本站使用日志核对。

OpenAI 兼容模式下，最终请求应类似 https://api.cocoapi.top/v1/chat/completions。如果客户端自动加 /v1，地址栏只填根地址；不要凭工具名称推断其所有版本都采用同一拼接规则。

获取模型列表成功不代表所有模型都可生成。部分客户端的「连接检查」使用固定测试模型，检查失败时应再核对它实际请求的模型和接口。

Claude 协议客户端

选择支持自定义网关地址和 Claude Messages 的客户端，根地址使用 https://api.cocoapi.top，最终请求端点为 /v1/messages。模型需确认支持这一协议。

若工具同时提供 API Key 与 Auth Token 两种模式，请按该工具版本的说明选择一种，不要同时配置互相冲突的凭证。代码示例见Claude Messages。

CC Switch 与编程工具

CC Switch 等工具可帮助管理多个供应商配置，但各目标应用使用的协议并不相同。切换服务商不会把仅支持 Chat Completions 的模型自动变成支持 Responses、工具调用或完整编程工作流的模型。

先确认目标工具所需协议、模型和自定义地址能力，再配置。当前文档不承诺所有编程工具一键兼容。

余额查询与模型调用也可能使用不同接口、权限或单位。请先在本站钱包查看余额；没有经过验证的查询模板不要直接使用，更不要把账户管理凭证交给不可信工具。

配置后仍不能用

检查顺序	要确认的内容
1. 地址	HTTPS 域名正确，路径没有重复 /v1，不是 /keys 网页地址
2. 凭证	使用本站 API Key，未过期，额度足够
3. 模型	模型标识、分组和协议一致
4. 网络	代理、系统 DNS、证书和出口网络是否有差异
5. 参数	关闭未经验证的工具、搜索、图片和扩展参数，先测纯文本

用同一枚密钥、同一模型和同一协议运行最小请求。若最小请求成功而客户端失败，可优先排查客户端路径与参数，但还需考虑二者代理和网络设置是否不同。