Python SDK 概览
先用 Python 跑通第一个请求，再去决定要不要深入 Responses、Chat 或平台接口。
Python SDK 适合数据处理脚本、后端服务、自动化任务和内部工具。它的价值不是把 HTTP 包一层壳，而是把模型请求、平台接口和后续管理能力收成一条稳定路径。 对大多数团队，先跑通一个最小请求，比一开始就读完整 API 参考更有效。
安装
pip
pip install therouter初始化
client.py
import os
from therouter import TheRouter
client = TheRouter(
api_key=os.getenv("THEROUTER_API_KEY"),
base_url="https://api.therouter.ai/v1",
)| Name | Type | Required | Description |
|---|---|---|---|
api_key | str | Required | 从 THEROUTER_API_KEY 读取的 key。第一次接入阶段，先只配它。 |
base_url | str | 默认就是 https://api.therouter.ai/v1，只有在代理或特殊环境里才需要改。 | |
timeout | float | 请求超时，单位秒。适合在批处理和后端服务里配合重试策略。 |
最小可用请求
Responses
response = client.responses.create(
model="openai/gpt-4o-mini",
input="把这份 deployment report 总结成 3 条 bullet。",
)
print(response.output_text)什么时候可以先不深入 SDK 细节
- 你还没跑通第一个请求，这时先不要读完整 API reference。
- 你还没决定主要使用 Chat 还是 Responses，不要先在高级参数上耗时间。
- 你当前最大的风险是 key、base URL 或模型命名没配对，而不是 SDK 本身。
环境变量
优先把
THEROUTER_API_KEY 交给 shell、CI secret 或部署平台，不要把 key 混进 notebook 或脚本常量里。治理能力可以晚一点再加，但不要把坏习惯先固化。