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-developmentcustomer-service-productioncherry-studio-macbook
2
复制并保存
创建后立即复制密钥。将它保存在密码管理器、密钥管理服务或本地环境变量中。
3
为不同应用分配不同密钥
开发环境、生产环境和第三方客户端分别使用独立密钥。出现异常时可以只撤销受影响的密钥。
第三步:保存环境变量
- macOS / Linux
- Windows PowerShell
- .env 文件
第四步:获取可用模型
不要从博客、截图或其他账户复制模型名称。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 有内容,表示第一次调用完成。第七步:启用流式响应
普通请求成功后,再验证流式输出。常见失败及处理
401:API Key 无效
401:API Key 无效
确认请求头格式为
Authorization: Bearer YOUR_API_KEY。检查环境变量是否为空、密钥是否复制完整、密钥是否已被撤销。403:没有访问权限
403:没有访问权限
检查账户状态、密钥权限和所选模型是否对当前账户开放。重新调用
/v1/models,不要继续使用未返回的模型 ID。404:请求地址错误
404:请求地址错误
Chat Completions 的完整地址是
https://api.hilinkup.com/v1/chat/completions。使用 SDK 时,Base URL 应为 https://api.hilinkup.com/v1。429:请求过多或额度受限
429:请求过多或额度受限
降低并发,等待后使用指数退避重试。检查控制台中的余额、额度和使用情况。
模型不存在或不可用
模型不存在或不可用
再次调用
/v1/models,复制完整 data[].id。模型列表可能因账户、渠道或时间变化。连接超时
连接超时
先用 cURL 测试基础连接,再检查本机代理、DNS、防火墙和公司网络。不要无限重试。
本页优先使用 Chat Completions,因为当前平台的大多数模型先支持该协议。需要 Responses 的 Agent 或客户端可以单独参考 Responses API;两种协议的请求体、输出字段和流式事件不同。
接下来做什么
迁移 OpenAI 项目
修改现有 SDK 的 API Key、Base URL 和模型 ID。
选择模型
根据能力、延迟、上下文和成本选择模型。
配置第三方应用
接入开发工具、聊天客户端和应用框架。
生产环境检查
配置超时、有限重试、日志脱敏和监控。