LinkNoca LinkNoca
OpenAI Compatible API

LinkNoca API 接入文档教程

LinkNoca 提供统一的 AI API 聚合入口,兼容 OpenAI 调用格式。你可以用同一套 API Key 调用聊天、图片、视频等模型,也可以接入 Cherry Studio、CCSwitch、NextChat、Open WebUI 等常见客户端。

快速开始

新用户只需要完成账号、余额和密钥三件事,就可以开始接入。客户端里选择 OpenAI 兼容协议, 然后填入 LinkNoca 的 API 地址和自己的 API Key。

注册或登录账号进入 LinkNoca 后创建账号,登录后进入控制台。
充值或兑换额度余额不足时无法调用模型。购买兑换码后,在充值兑换页面完成到账。
创建 API Key进入用户密钥页面,新建令牌并选择可用分组。
配置客户端API 地址填写 https://ahaoapi.top/v1,鉴权填写自己的 Key。

接口信息

API Base URL

https://ahaoapi.top/v1

协议格式

OpenAI Compatible

默认鉴权

Bearer API_KEY

常用接口

用途方法路径说明
模型列表GET/models获取当前 Key 可访问的模型。
聊天补全POST/chat/completions聊天、代码、文本生成类模型使用。
图片生成POST/images/generations图片模型使用,具体参数以模型能力为准。

请求头

字段示例说明
AuthorizationBearer sk-你的密钥必填,用于识别账户和扣费。
Content-Typeapplication/jsonJSON 请求必填。

获取 API Key

API Key 是你的调用凭证。不要把 Key 发到公开群、网页前端、GitHub 仓库或截图里。 如果怀疑泄露,直接在控制台删除旧 Key 并重新创建。

进入控制台点击顶部“控制台”,进入用户密钥或令牌管理页面。
新建令牌填写名称,例如“Cherry Studio”或“CCSwitch”,选择需要的模型分组。
复制并保存Key 只在创建后完整显示一次,建议保存到自己的密码管理工具。

建议不同客户端使用不同 Key。这样某个客户端出现异常时,可以单独停用,不影响其他工具。

模型选择

调用时在请求体的 model 字段填写模型名称。不同模型价格、速度和能力不同,正式使用前建议先在模型广场确认价格。

gpt-5.5 gpt-5.4 gpt-5.3-codex claude-sonnet-4-6 claude-opus-4-6 gemini-3.5-flash deepseek-v4-pro qwen-plus kimi-k2.6 doubao-seed-2.0-pro gpt-image-2

如果返回 model not found,通常是模型名称拼错,或者当前 Key 所在分组没有该模型权限。

调用示例

curl

Chat Completions
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

fetch 示例
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

Python 示例
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 / 403API Key 错误、已删除、无权限重新创建 Key,确认 Key 所属分组有模型权限。
insufficient quota余额不足或订阅到期充值兑换后重试。
model not found模型名称错误或分组未开放到模型广场复制准确模型名。
no available channel该模型暂时没有可用渠道换同类模型,或稍后再试。
service temporarily unavailable服务线路临时波动稍后重试,避免短时间高频重复请求。

安全建议

API Key 等同于账户调用权限,请像密码一样保管。不要把密钥写在公开网页前端,也不要把完整 Key 发给别人。

一端一 Key 发现泄露立即删除 不要公开截图 不要硬编码到前端 定期检查使用日志