快速开始

本页带你从一个空账户走到一次流式回复，并在用量日志里看到它。示例使用 OpenAI SDK，因为大多数项目里已经装了它；同一个密钥在 Anthropic 和 Google 的 SDK 中同样可用。

1. 1

   获取密钥

   注册账户后进入 API 密钥，点击 新建密钥。密钥以 ho- 开头，只显示这一次，关掉对话框前务必复制下来。

   用环境变量保存，别写进源码：

   Shell

   export HALFOFF_API_KEY="ho-..."

   账户里还需要有余额。在控制台用 PayPal 充值即可，详见余额与计费。

2. 2

   把客户端指向 Half Off Dev

   把客户端的地址改成 https://halfoff.dev/v1，再填入密钥，调用代码的其余部分保持不变。

   cURLPythonNode.js

   Shell

   curl https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-6.1-sol",
       "messages": [{"role": "user", "content": "用两句话解释什么是竞态条件。"}]
     }'

   想用原生 SDK？用 Anthropic SDK 调 Claude 见 Anthropic Messages，用 Google SDK 调 Gemini 见 Gemini。

3. 3

   边生成边输出

   把 stream 设为 true，然后逐块读取。事件格式与官方 API 完全相同。

   cURLPythonNode.js

   Shell

   curl -N https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{"model": "gpt-6.1-sol", "stream": true,
          "messages": [{"role": "user", "content": "列出太阳系的行星，每行一个。"}]}'

   更多细节见流式输出。

4. 4

   查看花了多少钱

   打开日志，每次调用几秒内就会出现，附带输入/输出 token 数、扣费金额、首 token 时间和每秒 token 数。每个响应还带有 x-halfoff-request-id 响应头，就某次调用联系客服时请提供它。

查找模型 ID#

GET /v1/models 无需密钥，返回所有模型及其上下文长度和价格。模型列表页面展示的是同样的数据。

curl https://halfoff.dev/v1/models

模型 ID 的匹配比较宽松：claude-sonnet-5.5、claude-sonnet-5-5 和 anthropic/claude-sonnet-5.5 指向同一个模型。

接下来#