客户端与 SDK

下面的示例都以国内直连地址 api-cn.heang.top 为例。在海外调用时，把它换成 api.heang.top 即可，其余不变。

所有示例都从环境变量读取 Key：

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

Python（OpenAI SDK）

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["STARKEY_API_KEY"],
    base_url="https://api-cn.heang.top/v1",
)

resp = client.chat.completions.create(
    model="step-3.5-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

流式输出：

stream = client.chat.completions.create(
    model="step-3.5-flash",
    messages=[{"role": "user", "content": "写一首关于星空的短诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js（OpenAI SDK）

npm install openai

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.STARKEY_API_KEY,
  baseURL: 'https://api-cn.heang.top/v1',
})

const resp = await client.chat.completions.create({
  model: 'step-3.5-flash',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

Responses 接口

需要工具调用或结构化输出时，可以用 Responses 接口：

curl https://api-cn.heang.top/v1/responses \
  -H "Authorization: Bearer $STARKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "模型名", "input": "用三个要点总结量子计算"}'

不是每个模型都支持 Responses，先在模型广场确认该模型标注的端点。

Claude Code

Claude Code 走 Anthropic Messages 协议。Base URL 不带 /v1，客户端会自己拼上 /v1/messages：

export ANTHROPIC_BASE_URL="https://api-cn.heang.top"
export ANTHROPIC_AUTH_TOKEN="$STARKEY_API_KEY"
export ANTHROPIC_MODEL="模型名"
claude

ANTHROPIC_MODEL 填模型广场里支持 Messages 端点的模型名。想长期生效，把这几行写进 ~/.zshrc 或 ~/.bashrc。

Codex CLI

编辑 ~/.codex/config.toml：

model = "模型名"
model_provider = "starkey"

[model_providers.starkey]
name = "星钥 StarKey"
base_url = "https://api-cn.heang.top/v1"
env_key = "STARKEY_API_KEY"
wire_api = "responses"

保存后在终端里确认 STARKEY_API_KEY 已设置，再运行 codex。

聊天客户端（Cherry Studio、ChatBox、LobeChat 等）

在客户端里新增一个 OpenAI 兼容 的服务商，填三项：

设置项	填什么
API 地址 / Base URL	https://api-cn.heang.top/v1（个别客户端只填到域名，会自动补 /v1）
API Key	你的星钥 Key
模型	从模型广场复制的模型名，可以添加多个

填完后用客户端自带的「检查连接」或发一句话测试。

LOOM 启动器

在启动器的模型设置里填同样的 Base URL、Key 和模型名，详见授权与模型。