LinkNoca API 接入文档教程
LinkNoca 提供统一的 AI API 聚合入口,兼容 OpenAI 调用格式。你可以用同一套 API Key 调用聊天、图片、视频等模型,也可以接入 Cherry Studio、CCSwitch、NextChat、Open WebUI 等常见客户端。
快速开始
新用户只需要完成账号、余额和密钥三件事,就可以开始接入。客户端里选择 OpenAI 兼容协议, 然后填入 LinkNoca 的 API 地址和自己的 API Key。
https://ahaoapi.top/v1,鉴权填写自己的 Key。接口信息
https://ahaoapi.top/v1
OpenAI Compatible
Bearer API_KEY
常用接口
| 用途 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 模型列表 | GET | /models | 获取当前 Key 可访问的模型。 |
| 聊天补全 | POST | /chat/completions | 聊天、代码、文本生成类模型使用。 |
| 图片生成 | POST | /images/generations | 图片模型使用,具体参数以模型能力为准。 |
请求头
| 字段 | 示例 | 说明 |
|---|---|---|
| Authorization | Bearer sk-你的密钥 | 必填,用于识别账户和扣费。 |
| Content-Type | application/json | JSON 请求必填。 |
获取 API Key
API Key 是你的调用凭证。不要把 Key 发到公开群、网页前端、GitHub 仓库或截图里。 如果怀疑泄露,直接在控制台删除旧 Key 并重新创建。
建议不同客户端使用不同 Key。这样某个客户端出现异常时,可以单独停用,不影响其他工具。
模型选择
调用时在请求体的 model 字段填写模型名称。不同模型价格、速度和能力不同,正式使用前建议先在模型广场确认价格。
如果返回 model not found,通常是模型名称拼错,或者当前 Key 所在分组没有该模型权限。
调用示例
curl
curl https://ahaoapi.top/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "你好,介绍一下 LinkNoca"
}
],
"temperature": 0.7
}'
JavaScript
const response = await fetch("https://ahaoapi.top/v1/chat/completions", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer sk-你的密钥"
},
body: JSON.stringify({
model: "gpt-5.5",
messages: [
{ role: "user", content: "写一个三句话的产品介绍" }
]
})
});
const data = await response.json();
console.log(data.choices[0].message.content);
Python OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://ahaoapi.top/v1",
)
completion = client.chat.completions.create(
model="gpt-5.5",
messages=[
{"role": "user", "content": "你好,介绍一下 LinkNoca"}
],
)
print(completion.choices[0].message.content)
客户端接入
Cherry Studio
| 配置项 | 填写内容 |
|---|---|
| 服务商类型 | OpenAI 或 OpenAI Compatible |
| API 地址 | https://ahaoapi.top/v1 |
| API Key | 填写你在 LinkNoca 创建的密钥 |
| 模型 | 选择模型列表中的可用模型,例如 gpt-5.5 |
CCSwitch
| 配置项 | 建议填写 |
|---|---|
| 供应商标识 | linknoca |
| 供应商名称 | LinkNoca |
| API 模式 | OpenAI Chat Completions |
| API 端点 | https://ahaoapi.top/v1 |
| API Key | 填写你自己的 LinkNoca Key |
其他客户端只要支持 OpenAI 兼容接口,基本都可以按同样方式填写:Base URL、API Key、模型名称。
充值与兑换
LinkNoca 当前支持通过兑换码到账。购买后获得兑换码,在“充值兑换”页面输入即可增加余额或开通订阅。
兑换后增加站内余额,按模型价格扣费。
兑换后开通对应订阅,有效期以页面展示为准。
不同模型扣费不同,高价值模型消耗会更快。
计费说明
聊天模型通常按输入 Token 和输出 Token 分别计费。图片、视频、音频等模型可能按次或按模型规则计费。 具体价格以模型广场显示为准。
| 类型 | 计费方式 | 建议 |
|---|---|---|
| 聊天 / 代码 | 输入、输出 Token 分别计费 | 长上下文会明显增加消耗。 |
| 图片生成 | 通常按次或按图片模型价格计费 | 先用低成本模型测试提示词。 |
| 视频生成 | 通常按任务、时长或模型规则计费 | 提交前确认尺寸、时长和模型。 |
常见错误
| 提示 | 常见原因 | 处理方式 |
|---|---|---|
| 401 / 403 | API Key 错误、已删除、无权限 | 重新创建 Key,确认 Key 所属分组有模型权限。 |
| insufficient quota | 余额不足或订阅到期 | 充值兑换后重试。 |
| model not found | 模型名称错误或分组未开放 | 到模型广场复制准确模型名。 |
| no available channel | 该模型暂时没有可用渠道 | 换同类模型,或稍后再试。 |
| service temporarily unavailable | 服务线路临时波动 | 稍后重试,避免短时间高频重复请求。 |
安全建议
API Key 等同于账户调用权限,请像密码一样保管。不要把密钥写在公开网页前端,也不要把完整 Key 发给别人。