文档
Half Off Dev 文档
以官方定价一半的价格调用 Claude、GPT 和 Gemini 原生 API。只换 base URL 和密钥，代码一行不用改。
Half Off Dev 提供 Anthropic、OpenAI 和 Google 的前沿模型，所有模型一律按官方标价的 5 折计费。接入方式也很简单：SDK、请求体、常用的命令行程序都保持原样，只需改两处配置——base URL（https://halfoff.dev）和 API 密钥。费用按 token 从预付余额中扣除。
用现有 SDK 试一下#
下面用 Anthropic SDK 调用 Claude。和直连官方相比，区别只有 base URL 和密钥两项。
Shell
curl https://halfoff.dev/v1/messages \
-H "x-api-key: $HALFOFF_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5.5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "给一个代码审查机器人起三个名字。"}]
}'同一个密钥也能通过 OpenAI SDK 调用 GPT，通过 Google Gen AI SDK 调用 Gemini。
各 SDK 的接入地址#
| 你在用 | base URL 设为 | 密钥放在 |
|---|---|---|
| Anthropic SDK、Claude Code | https://halfoff.dev | x-api-key 或 Authorization: Bearer |
| OpenAI SDK、Codex CLI、OpenAI 兼容应用 | https://halfoff.dev/v1 | Authorization: Bearer |
| Google Gen AI SDK、Gemini CLI | https://halfoff.dev | x-goog-api-key |
为什么可以无缝替换#
- 全系模型 5 折。 每个 token 都按该模型官方价格的 50% 计费。实时价格见
GET /v1/models和价格说明。 - 不做格式转换。 Messages 请求按 Messages 返回，Chat Completions 按 Chat Completions 返回，Gemini 请求按 Gemini 返回。流式输出、函数调用、扩展思考、提示缓存的行为都和官方文档一致。详见网关工作原理。
- 三个渠道组。 Claude · Value、GPT · Value、Gemini · Value 共用一个容量池。短时突发流量会排队几秒而不是直接报错；某次调用失败时，会先换一条渠道重试，再决定是否把错误返回给你。详见渠道组和速率限制。
- 缓存不掉线。 同一段对话固定走持有其提示缓存的渠道，重复的上下文持续按缓存输入价计费。详见提示缓存。
- 预付费，没有账单。 先通过 PayPal 充值余额，请求从余额中扣费；余额归零后请求即停止，不会事后追加收费。详见余额与计费。
- 每次调用都有记录。 每个请求的 token 数、费用、延迟和状态都会出现在控制台日志中。详见用量。
把文档交给你的 AI 助手
在任意文档地址后加 .md 即可拿到纯 Markdown 版本；也可以把 /llms.txt 交给编程助手，让它读取完整索引。
需要帮助#
关于某次调用、某笔扣费或账户的问题，请在控制台的工单支持中提交，并附上响应头 x-halfoff-request-id（如有）。服务实时状态见状态页。