HengRoute Python SDK

HengRoute（OpenAI 兼容 AI 网关）官方 Python SDK。一个 Key 调所有模型，流式/非流式都支持。

安装

pip install hengroute

快速开始

from hengroute import Hengroute

client = Hengroute(api_key="sk-xxx", base_url="https://gw.example.com")

# 非流式
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp["choices"][0]["message"]["content"])

# 流式（SSE）
for chunk in client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True,
):
    delta = chunk["choices"][0]["delta"].get("content", "")
    print(delta, end="", flush=True)

# 模型列表
for m in client.models.list():
    print(m["id"])

# 向量
resp = client.embeddings.create(model="text-embedding-v3", input="你好")

配置

• api_key / base_url 也可通过环境变量 HENGROUTE_API_KEY / HENGROUTE_BASE_URL 提供。
• 调用方不需要任何上游厂商 Key；网关统一错误码会映射为异常：AuthenticationError(401)、RateLimitError(429)、ApiError(其他)。