集成

OpenAI 兼容应用

任何支持自定义 OpenAI 端点的应用、框架或库，都能通过 Half Off Dev 以官方半价调用 Claude、GPT 和 Gemini。

大量应用和库都允许把 OpenAI 的接入地址换成你自己的。换成 Half Off Dev 的地址后，它们除了 GPT 还能直接用上 Claude 和 Gemini：Half Off Dev 在 https://halfoff.dev/v1 为所有文本模型提供 OpenAI Chat Completions 接口，而且一律按官方价格的一半计费。开始前请先创建 API 密钥。

三项设置#

找到“自定义端点”“Base URL”或“OpenAI 兼容”之类的选项，填入：

字段	值
Base URL	`https://halfoff.dev/v1`
API 密钥	你的 `ho-...` 密钥
模型	`GET /v1/models` 中的任意 ID，例如 `claude-sonnet-5.5` 或 `gpt-6.1-sol`

有些应用要求填写 API 地址（host），并会自己加上 /v1，这种情况只填 https://halfoff.dev。

用环境变量配置#

基于官方 OpenAI 或 Anthropic SDK 开发的程序，通常会从环境变量读取接入地址，所以可能根本不用改它的设置：

Shell

# 基于 OpenAI SDK 的程序
export OPENAI_BASE_URL=https://halfoff.dev/v1
export OPENAI_API_KEY=$HALFOFF_API_KEY

# 基于 Anthropic SDK 的程序
export ANTHROPIC_BASE_URL=https://halfoff.dev
export ANTHROPIC_API_KEY=$HALFOFF_API_KEY

自己写客户端？SDK 有 Python 和 Node.js 示例，OpenAI Chat Completions 介绍了流式输出、函数调用和支持的字段。

常见报错#

现象	处理方法
`401` `Missing API key`	密钥没有发到 Half Off Dev。检查变量名，并确认是在启动程序的 shell 中 export 的。
`401` `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或新建一个。
`404` `Model '...' is not available`	模型 ID 不存在。从 `GET /v1/models` 或模型列表复制。
`404` `Unknown endpoint`	程序调用了 Half Off Dev 不提供的 API，例如 embeddings。改用 Chat Completions、Responses、Anthropic Messages 或 Gemini 格式。
`404` `not served in responses format`	Responses API 只提供 GPT 模型。选 `gpt-*` 模型，或者用 Chat Completions 调用 Claude 和 Gemini。
`404` 且路径里有 `/v1/v1/`	程序会自己加 `/v1`。地址填 `https://halfoff.dev`。
`402`	余额已用完，或密钥达到消费上限。见余额与计费。

其他状态码见错误码。