集成

SDK

在官方 OpenAI、Anthropic 和 Google Gen AI SDK 中设置两个客户端参数，即可通过 Half Off Dev 以官方半价调用模型。

Half Off Dev 按各家原有格式提供 API，所以不需要任何专用客户端库。安装官方 SDK，创建客户端时传入 Half Off Dev 的 base URL 和你的密钥，之后的用法全部参照官方文档即可。开始前请先创建 API 密钥。

在 API 密钥页面的 接入客户端 中，cURL / SDK 标签页提供了已填好密钥的示例代码。

Anthropic SDK#

base URL 填 https://halfoff.dev，不带 /v1，版本路径由 SDK 自己添加。

Python

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://halfoff.dev",
    api_key=os.environ["HALFOFF_API_KEY"],
)
message = client.messages.create(
    model="claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "给一个批量重命名文件的命令行程序起个名字。"}],
)
print(message.content[0].text)

OpenAI SDK#

base URL 填 https://halfoff.dev/v1。

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://halfoff.dev/v1",
    api_key=os.environ["HALFOFF_API_KEY"],
)
completion = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "写一个匹配 ISO 日期格式的正则表达式。"}],
)
print(completion.choices[0].message.content)

Chat Completions 支持所有文本模型，同一个客户端改一下 model，就能调用 claude-sonnet-5.5 或 gemini-3.1-pro。

Google Gen AI SDK#

base URL 填 https://halfoff.dev，通过 HTTP 选项传入。

Python

import os
from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["HALFOFF_API_KEY"],
    http_options=types.HttpOptions(base_url="https://halfoff.dev"),
)
response = client.models.generate_content(
    model="gemini-3.1-pro",
    contents="用一段话概括 CAP 定理。",
)
print(response.text)

各格式的细节：Anthropic Messages、OpenAI Chat Completions、Gemini。

常见报错#

现象	处理方法
`401` `Missing API key`	客户端没有发送密钥。确认代码运行环境中设置了 `HALFOFF_API_KEY`。
`401` `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或新建一个。
`404` `Model '...' is not available`	模型 ID 不存在。从 `GET /v1/models` 或模型列表复制。
`404` 且路径里有 `/v1/v1/`	给 Anthropic SDK 传了 `https://halfoff.dev/v1`。它会自己加 `/v1`，请传 `https://halfoff.dev`；只有 OpenAI SDK 需要带 `/v1`。
`402`	余额已用完，或密钥达到消费上限。见余额与计费。

其他状态码见错误码。