Python
入门 · 约 8 分钟
使用 Python SDK 接入 OpenAI 兼容 API
如果现有项目已经使用 OpenAI Python SDK，通常只需替换 API Key、base_url 和模型名称即可接入。
开始前准备
- Python 3.10 或更高版本
- 已创建 AINN API Key
- 已从模型广场确认模型名称
1
步骤 1
安装 OpenAI Python SDK
建议在项目虚拟环境中安装依赖，避免与系统 Python 包冲突。
Terminal
python -m pip install --upgrade openai
2
步骤 2
配置 API Key 环境变量
不要把真实 API Key 提交到 Git 仓库，也不要放进可被浏览器下载的前端代码。
macOS / Linux
export AINN_API_KEY="你的 API Key"Windows PowerShell
$env:AINN_API_KEY="你的 API Key"
3
步骤 3
创建客户端并发送请求
base_url 指向 AINN API 的兼容接口。把 your-model 替换为模型广场中的实际模型标识。
example.py
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AINN_API_KEY"],
base_url="https://api.ainn.cc/v1",
)
response = client.chat.completions.create(
model="your-model",
messages=[
{"role": "system", "content": "你是一个简洁的中文助手。"},
{"role": "user", "content": "给我三个学习 Python 的建议。"},
],
)
print(response.choices[0].message.content)
4
步骤 4
运行并验证
执行脚本后检查终端输出和控制台调用记录。如果需要在 Web 项目中使用，应只从服务端调用 API。
- 为生产请求设置合理超时和异常处理
- 记录请求标识和错误信息，但不要记录完整 API Key
- 先用成本计算器估算批量任务的月度消耗
Terminal
python example.py完成检查
- 脚本能正常打印模型回复
- API Key 未写入源代码
- 控制台中出现本次用量记录
继续完成项目接入
选择合适模型并估算实际成本
教程中的模型名只是占位符。请根据业务场景选择当前可用模型，再用真实 Token 用量估算预算。