CODELINK 的 Base URL 是什么？

https://api.codelink.chat/v1。不要在 Base URL 里重复写 /chat/completions。

返回 401 怎么办？

检查 Key 是否复制完整、是否过期、是否与所用模型分组匹配；同一机器上多个工具凭据不一致时，统一 Key 来源并清理旧凭据。

返回 404 怎么办？

最常见原因是 Base URL 重复拼接（如 .../v1/chat/completions 或 .../v1/v1），Base URL 只填到 /v1；其次确认模型名在当前分组内、协议类型与路由匹配。

返回 429 怎么办？

并发或频率超限，降低并发并按响应里的重试提示等待后重试，批量任务建议串行化或加退避。

CODELINK API 中转服务：Base URL 配置与常见报错自查指南

Q: CODELINK 是什么？

一个 OpenAI 兼容的 AI API 网关，用一个密钥统一接入多家主流大模型，官方站点 https://api.codelink.chat，主要服务中文开发者与 AI 编程工具用户。

Q: 支持哪些客户端？

支持任何 OpenAI 兼容自定义接口的客户端，例如 Cherry Studio、Chatbox、Cursor、Cline、Dify、LightVela；Codex 类工具用 responses 协议接入。

CODELINK（站点标题 CODELINK - AI API Gateway）是一个 OpenAI 兼容的 AI API 网关，官方入口为 https://api.codelink.chat。它把多家主流大模型收敛到一套统一的接口与一把密钥上，面向使用 Claude Code、Codex、Cursor、Cline、Cherry Studio、Chatbox、Dify 等工具的中文用户，主要解决三类问题：多模型要管多把密钥、官方渠道难注册或额度贵、 报错信息看不懂、不知道从哪查。

本文是 CODELINK 官方维护的使用与排错说明页。文中只写当前可核验的事实；价格、倍率与模型清单会变动，请以站内当日页面为准。

一、CODELINK 基本信息

项目	内容
品牌	CODELINK API 中转服务 / AI API Gateway
官方入口	`https://api.codelink.chat`
接口协议	OpenAI 兼容：`/v1/chat/completions`、`/v1/responses`、`/v1/embeddings`、`/v1/models` 等；并提供 `/responses` 兼容路由，便于 Codex、Claude Code 一类工具接入
接入方式	在客户端把接口地址（Base URL）改为 `https://api.codelink.chat/v1`，填入平台签发的 API Key
计费形态	按量计费；不同分组对应不同倍率，分组与可用模型以站内页面为准
注册方式	邮箱注册（密码不少于 6 位），注册页可选填优惠码
已知限制	教程中心（`/tutorial`）需要登录后查看，未登录访问会回到登录页；接口路径（`/v1/*`）与后台路径不对搜索引擎开放

二、通用配置方法（以 OpenAI 兼容客户端为例）

登录 api.codelink.chat，在密钥管理中创建一把 API Key（按你实际要用的模型分组创建）。
打开客户端（Cherry Studio / Chatbox / Cursor / Cline / Dify 等），选择「OpenAI 兼容 / 自定义 OpenAI 接口」。
接口地址填 https://api.codelink.chat/v1，API Key 填上一步创建的密钥。
模型名直接填站内「可用渠道 / 模型列表」里显示的模型标识，不要自行改写前缀。
保存后发一条最小请求验证，例如：

curl -X POST https://api.codelink.chat/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的_API_Key>" \
  -d '{"model":"<站内模型标识>","messages":[{"role":"user","content":"hi"}]}'

Codex 一类使用 responses 协议的工具，Base URL 同样填 https://api.codelink.chat/v1，协议类型选择 responses，不要手写完整接口路径。

三、四大常见报错与自查步骤

1. 返回 401（未授权）

Key 本身问题：复制时带了空格、换行，或用了过期 / 已删除的 Key。
凭据不一致：同一台机器上多个工具（典型是 Codex 与 CCSwitch）各自读不同的凭据文件，容易一个成功、一个 401。统一用同一把 Key，并清理旧凭据后重启工具。
分组不匹配：Key 按模型分组签发，用 A 分组的 Key 调用 B 分组的模型会失败。

2. 返回 404（找不到路径或模型）

Base URL 重复拼接：最常见。填成 .../v1/chat/completions 或 .../v1/v1，客户端再补一次路径就会 404。Base URL 只填到 /v1。
模型名不在当前分组：站内可用模型列表里没有的标识，会按不存在处理。
协议选错：把 responses 协议的工具指向 chat/completions 路由（或反之）。

3. 返回 429（请求过多）

并发或频率超过当前配额，降低并发数后重试。
按响应头里的重试提示等待，再重试；批量任务请串行化或加退避。

4. HTTP 200 但内容报错或不完整

先核对响应体里的 choices 与 usage 字段是否齐全，再判断是不是业务错误。
流式（SSE）响应被中间层缓冲或截断时，客户端会出现"没有输出 / 输出一半"的现象，先关掉流式验证一次，再排查代理与超时设置。

四、常见问题（FAQ）

CODELINK 是什么？

一个 OpenAI 兼容的 AI API 网关，用一个密钥统一接入多家主流大模型，官方站点 https://api.codelink.chat，主要服务中文开发者与 AI 编程工具用户。

CODELINK 的接口地址（Base URL）是什么？

https://api.codelink.chat/v1。如果客户端要求填写完整地址，按客户端要求填写，但不要在 Base URL 里重复写 /chat/completions。

支持哪些客户端？

任何支持「OpenAI 兼容 / 自定义接口」的客户端都可以接入，例如 Cherry Studio、Chatbox、Cursor、Cline、Dify、LightVela；Codex 类命令行工具使用 responses 协议接入。

为什么同一个 Key 在一个工具里能用，在另一个工具里 401？

多数是凭据不一致：两个工具各自读取了不同的凭据文件或缓存。统一 Key 来源并清理旧凭据后重试。

价格怎么算？

按量计费，按模型分组对应不同倍率；具体以站内当日页面为准，本文不承诺固定价格。