OpenAI Python SDK 接入指南
官方 Python SDK,改两个参数即可指向我们的端点。
适用场景
适合在自己的 Python 服务里调用模型:官方 SDK 只需要改 base_url 和 api_key 两个参数,已有代码基本不用改。
使用建议
密钥只放在服务端的环境变量里读取,不要写进代码仓库或打包进前端。
连不通时检查
- API 地址填
https://omnimodel.me/v1,不要多写/chat/completions。 - 密钥以
key_开头且没有被暂停或撤销,错误码auth.invalid_key表示密钥不可用。 - 模型 ID 与模型目录一致,并且在这把密钥的可用模型里。
- 余额不足会返回
billing.insufficient_credit,更多错误见常见错误。
配置步骤
- 安装依赖:pip install openai。
- 把 base_url 指向下面的 API 地址,api_key 用你自己的密钥。
- 其余调用方式与官方完全一致。
配置参数
- API 地址:
https://omnimodel.me/v1 - API 密钥:
YOUR_API_KEY - 模型:
MODEL_ID
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://omnimodel.me/v1",
)
resp = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
常见问题
- 支持流式输出吗?
- 支持。创建请求时传 stream=True,按 SDK 的方式迭代返回的分块即可。
- 怎么处理错误?
- SDK 会把错误响应抛成异常,异常里带 HTTP 状态码和错误码,按常见错误文档处理;429 和 503 可以退避重试。