Metadata-Version: 2.4
Name: hengroute
Version: 0.4.1
Summary: HengRoute - OpenAI 兼容 AI 网关官方 Python SDK
Author: HengRoute contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/520atp/hengroute
Project-URL: Source, https://github.com/520atp/hengroute
Keywords: llm,gateway,openai,ai,hengroute
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# HengRoute Python SDK

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

## 安装

```bash
pip install hengroute
```

## 快速开始

```python
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`(其他)。
