安装与准备
在项目虚拟环境中安装依赖，生产环境测试后锁定依赖版本。
python -m venv .venv
# Bash 激活：source .venv/bin/activate
# Windows PowerShell 激活：.venv\Scripts\Activate.ps1
python -m pip install openai按鉴权指南设置三个环境变量。QINGYUN_TOP_BASE_URL 应为 https://top.qingyuntop.ai/v1，模型 ID 从本站复制。
保存为 app.py
import os
import openai
from openai import OpenAI
client = OpenAI(
api_key=os.environ["QINGYUN_TOP_API_KEY"],
base_url=os.environ["QINGYUN_TOP_BASE_URL"],
timeout=60.0,
max_retries=0,
)
try:
result = client.chat.completions.create(
model=os.environ["QINGYUN_TOP_MODEL"],
messages=[{"role": "user", "content": "请用一句话解释 API"}],
)
print(result.choices[0].message.content or "返回没有普通文本，请检查完成原因")
except openai.APIStatusError as error:
print("HTTP 状态:", error.status_code)
print("请求 ID:", error.request_id)
raise SystemExit(1)
except openai.APIConnectionError:
print("连接失败或超时，请检查网络和 Base URL")
raise SystemExit(1)
finally:
client.close()运行 python app.py。提示 KeyError 时说明对应环境变量尚未设置，或程序不是从设置变量的终端启动。
接入业务前
Web 服务优先使用 AsyncOpenAI 配合异步请求，不要在事件循环中执行同步阻塞调用。按进程复用客户端并在关闭服务时释放连接；不要为每次请求重新安装或初始化依赖。
示例关闭自动重试是为了让首次错误可见；上线时按限流与重试设计有限重试，避免 SDK 与业务层叠加。