Python 调用 OuraiC：OpenAI SDK 的最小聊天示例
Python 应用可通过 OpenAI SDK 的自定义基址调用 OpenAI 兼容服务。接入 OuraiC 时，把 base_url 设为 https://ouraic.cn/v1，使用本站 Key 和当前可用 Model ID。SDK 能发送某种请求，不代表本站实现了官方 API 的每项功能。
图：按本文操作要点制作的说明图，不是后台或调用成功截图。
安装与准备
在虚拟环境中运行 python -m pip install openai。为执行程序的进程设置 OURAIC_API_KEY 和 OURAIC_MODEL，不要提交密钥到仓库。
import os
from openai import OpenAI, APIStatusError, APIConnectionError
client = OpenAI(
api_key=os.environ["OURAIC_API_KEY"],
base_url="https://ouraic.cn/v1",
timeout=60.0,
max_retries=0,
)
try:
result = client.chat.completions.create(
model=os.environ["OURAIC_MODEL"],
messages=[{"role": "user", "content": "请只回答 OK"}],
)
print(result.choices[0].message.content)
except APIStatusError as exc:
print("HTTP status:", exc.status_code)
except APIConnectionError:
print("连接失败：检查网络与超时")
调试阶段关闭自动重试，便于确认一次操作产生多少次调用。正式使用再按错误类型添加有限重试，避免对无效 Key 和错误路径重复请求。
运行后检查
看程序是否收到文本，再核对本站消费记录中的模型、分组和时间。下一步单独测试多轮、流式和工具调用，不要一次增加大量参数。
如果提示缺少环境变量，检查运行进程是否继承变量。IDE、容器和系统服务可能有独立环境，一个终端配置过不代表所有进程都能读到。
常见配置问题
model 填写请求 ID，不是中文显示名称。不要给所有模型统一增加 openai/ 前缀。基址已有 /v1 时，不要再附加完整聊天路径。
HTTP 成功但解析失败时，保存脱敏响应样例，检查它是否符合 Chat Completions 结构。遇到工具调用响应，也不能只期待普通文本。
接入业务的下一步
先单请求验证，再连接数据库或工作流。给输入设长度边界，给长任务设预算，并记录错误状态。Key 保留在服务端，前端调用自己的业务接口。