Skip to main content
按照本页操作,你将完成一个真实可用的 HiLinkup 接入:创建密钥、确认模型、发送请求并验证返回结果。
API Base URL:https://api.hilinkup.com/v1

完成后你会得到什么

  • 一个可独立撤销的 API Key
  • 当前账户真正可用的模型 ID
  • 一段可以继续开发的 Python、Node.js 或 cURL 示例
  • 一套判断请求是否成功的方法

第一步:注册并进入控制台

1

登录 HiLinkup

打开 HiLinkup 主站,登录或创建账户。
2

进入 API Key 页面

打开 API Key 管理。
3

确认账户可用

如果账户需要充值、授权或完成其他准备操作,请先在控制台完成。调用前应确保账户状态正常。

第二步:创建 API Key

1

新建密钥

点击创建 API Key。名称建议写明用途和环境,例如:
  • local-development
  • customer-service-production
  • cherry-studio-macbook
2

复制并保存

创建后立即复制密钥。将它保存在密码管理器、密钥管理服务或本地环境变量中。
API Key 等同于账户调用凭证。不要发送到聊天群、截图、前端代码或 Git 仓库。
3

为不同应用分配不同密钥

开发环境、生产环境和第三方客户端分别使用独立密钥。出现异常时可以只撤销受影响的密钥。

第三步:保存环境变量

验证变量已经写入当前终端:

第四步:获取可用模型

不要从博客、截图或其他账户复制模型名称。GET /v1/models 返回当前 API Key 此刻可以使用的模型。
成功响应示意:
owned_by 是供应商,id 的完整格式是 供应商/模型。复制 data[].id 的完整值可显式指定供应商,例如 aliyun/kimi-k3;只传 kimi-k3 时不指定供应商,由平台当前的默认供应商设置处理。后续示例使用 aliyun/kimi-k3,如果你的返回结果中没有这个 ID,请替换成实际可用模型。
收到 HTTP 200,并且 data 数组至少包含一个模型,表示鉴权和模型访问正常。

第五步:发送第一次 Chat Completions 请求

当前平台的大多数模型优先支持 OpenAI-compatible Chat Completions。任选一种方式即可;如果你只是验证连接,建议先使用 cURL。

第六步:检查响应

成功响应通常包含以下字段: 示意:
HTTP 状态为 200,并且 choices[0].message.content 有内容,表示第一次调用完成。

第七步:启用流式响应

普通请求成功后,再验证流式输出。
流式响应的完整处理方式见流式响应。

常见失败及处理

确认请求头格式为 Authorization: Bearer YOUR_API_KEY。检查环境变量是否为空、密钥是否复制完整、密钥是否已被撤销。
检查账户状态、密钥权限和所选模型是否对当前账户开放。重新调用 /v1/models,不要继续使用未返回的模型 ID。
Chat Completions 的完整地址是 https://api.hilinkup.com/v1/chat/completions。使用 SDK 时,Base URL 应为 https://api.hilinkup.com/v1。
降低并发,等待后使用指数退避重试。检查控制台中的余额、额度和使用情况。
再次调用 /v1/models,复制完整 data[].id。模型列表可能因账户、渠道或时间变化。
先用 cURL 测试基础连接,再检查本机代理、DNS、防火墙和公司网络。不要无限重试。
本页优先使用 Chat Completions,因为当前平台的大多数模型先支持该协议。需要 Responses 的 Agent 或客户端可以单独参考 Responses API;两种协议的请求体、输出字段和流式事件不同。

接下来做什么

迁移 OpenAI 项目

修改现有 SDK 的 API Key、Base URL 和模型 ID。

选择模型

根据能力、延迟、上下文和成本选择模型。

配置第三方应用

接入开发工具、聊天客户端和应用框架。

生产环境检查

配置超时、有限重试、日志脱敏和监控。
最后修改于 2026年8月12日