快速接入

星钥 StarKey 提供 OpenAI 兼容接口。按下面四步做完，就能把调用接进你的应用、编辑器或自动化工具。

1. 注册并创建 API Key

1. 打开 api.heang.top，用邮箱验证码、GitHub 或 Passkey 注册登录。
2. 进入控制台的 API Keys 页面，点击创建。
3. 密钥只在创建时完整显示一次，立刻保存到服务端环境变量里：

export STARKEY_API_KEY="sk-你的星钥Key"

保管好你的 Key

不要把 API Key 写进前端页面、公开仓库、截图或聊天记录。一旦泄露，马上在控制台删除旧 Key，再创建一把新的。

2. 选择 Base URL

你在哪	OpenAI 兼容地址
中国大陆	https://api-cn.heang.top/v1
海外	https://api.heang.top/v1

两个地址是同一套服务，账号、Key 和余额通用。支持 OpenAI API 的客户端，基本都可以直接填这条地址。

3. 发出第一个请求

先确认 Key 可用，列出它能调用的模型：

curl https://api-cn.heang.top/v1/models \
  -H "Authorization: Bearer $STARKEY_API_KEY"

再发一条对话请求。把 model 换成模型广场里复制的准确名称：

curl https://api-cn.heang.top/v1/chat/completions \
  -H "Authorization: Bearer $STARKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "step-3.5-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

返回里有 choices[0].message.content 就说明接通了。

4. 开启流式输出

长回答和写代码的任务建议开流式，客户端边生成边显示，也不容易因为等待太久而超时：

{
  "model": "step-3.5-flash",
  "messages": [{"role": "user", "content": "解释这段代码"}],
  "stream": true
}

客户端需要按 Server-Sent Events（SSE）逐行读取返回。官方 SDK 都已经处理好了，见客户端与 SDK。

下一步

• 客户端与 SDK：Python、Node、Claude Code、Codex 的现成配置
• 模型与价格：按任务选模型，看清价格
• 错误排查：调用失败时的检查顺序