EZLink API 使用说明

适合新手用户，按照步骤操作即可开始使用 API。

一眼看懂

使用 API 只需要 3 步：

  1. 登录网站
  2. 自己创建 API 密钥
  3. 把 API Key + Base URL 填到软件里

网站地址：

https://api.ezlinkapi.top

常用 Base URL：

https://api.ezlinkapi.top/v1

一、用户如何自己创建 API Key？

登录网站后，按照下面步骤操作：

左侧菜单 → 令牌管理 → 新建令牌

然后填写：

项目 怎么填
令牌名称 随便写，比如“我的测试密钥”
令牌分组，最重要！！ 选择你想用的模型分组
额度 默认即可
过期时间 默认即可
模型权限 默认即可
状态 启用

创建成功后，会生成一个类似这样的密钥：

sk-xxxxxxxxxxxxxxxx

这个就是你的 API Key。

请复制保存好自己的 API Key，不要发到公开群里，也不要随便截图泄露。

二、API 怎么填写？

在支持 OpenAI Compatible / OpenAI 兼容接口 的软件里填写：

API Key：你创建的 sk-xxxxxxxx
Base URL：https://api.ezlinkapi.top/v1
接口类型：OpenAI Compatible / OpenAI 兼容
模型名称：选择网站支持的模型

如果软件不支持 /v1，可以尝试填写：

https://api.ezlinkapi.top

三、CCSwitch 怎么用？

CCSwitch 可以用来配置 Claude Code、Codex、OpenCode、Gemini CLI 等工具。

操作步骤

  1. 打开 CCSwitch。
  2. 选择你要配置的软件，例如：Claude Code、Codex、OpenCode、Gemini。
  3. 点击 Add Provider / 添加供应商。
  4. 选择 Custom / 自定义。
  5. 填写下面的信息。
Name：EZLink API
API Key：你在网站创建的 sk-xxxxxxxx
Base URL：https://api.ezlinkapi.top/v1
Model：网站支持的模型名称
API Format：OpenAI Compatible
  1. 点击保存。
  2. 点击启用。
  3. 看到 Active / 已启用，就说明配置成功。

如果报错，可以把 Base URL 改成：

https://api.ezlinkapi.top

然后重新保存启用。

四、最简单测试方式

复制下面命令，把 sk-你的API_KEY 换成你自己创建的 API Key：

curl https://api.ezlinkapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'
如果返回 AI 回复，说明 API 可以正常使用。

五、常见问题

1. 401 错误

一般是 API Key 填错了。

请检查格式是否正确：

Authorization: Bearer sk-xxxxxxxx

注意：Bearer 后面要有一个空格。

2. 404 错误

一般是 Base URL 写错了。

推荐填写：

https://api.ezlinkapi.top/v1

不要写成：

https://api.ezlinkapi.top/v1/v1

3. model not found

一般是模型名称写错，或者当前账号没有权限使用这个模型。

解决方法：

换一个网站支持的模型名称

4. no available channel

一般是后台通道暂时不可用。

可以稍后再试，或者联系网站管理员处理。

六、直接复制填写模板

网站地址：https://api.ezlinkapi.top

API Key：登录网站后，在【令牌管理】里自己创建

Base URL：https://api.ezlinkapi.top/v1

接口类型：OpenAI Compatible / OpenAI 兼容

模型名称：选择网站支持的模型

七、一句话总结

登录网站 → 令牌管理创建 API Key → 填入 Base URL 和模型名 → 开始使用