教程 / 接入
用 OpenAI 官方 SDK 接入
不用换 SDK,也不用重写请求层:把 base_url 指向 Aisoui,model 换成平台上的模型 ID,其余代码原样保留。
Aisoui 的对话接口是 OpenAI 兼容层:路径、鉴权头、请求体、流式返回格式都按 OpenAI 的约定来。所以已有的 Python / Node 项目,通常只需要改两个字符串。
三步换过来
- 注册后进控制台 → API 密钥 → 创建,拿到 sk-live- 开头的密钥(只展示一次)。
- 把 base_url 从 https://api.openai.com/v1 改成 https://api.aisoui.com/v1。
- 把 model 换成平台上的模型 ID,例如 gemini-3.8-flash,不要用 OpenAI 的模型名。
对话补全
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.aisoui.com/v1",
)
completion = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "用三句话介绍你自己"}],
)
print(completion.choices[0].message.content)不确定有哪些模型可用,就请求 GET /v1/models。这个接口只支持 GET,用 POST 会返回 405。
常见报错对照
| 现象 | 大概率原因 | 怎么办 |
|---|---|---|
| 401 Unauthorized | 密钥没带、带错,或已被吊销 | 检查 Authorization: Bearer sk-live-…;到控制台确认密钥状态 |
| 404 model not found | 用了 OpenAI 的模型名,或该模型未开通 | GET /v1/models 查实际可用的 ID |
| 余额不足,请先充值 | 账户余额低于调用门槛 | 控制台充值后重试,最低 ¥20 起充 |
| 429 / 超时 | 并发过高或上游繁忙 | 退避重试;持续出现时换更小的模型或错峰 |
OpenAI 生态里的 LangChain、Dify、各类 Bot 框架都是同一套调用方式,配置项里一般就叫「Base URL」和「API Key」,填法见另一篇 LangChain 与 Dify 配置。
常见问题
- 能直接用官方的 openai 包吗?
- 能。base_url 指过来就行,不需要装任何私有 SDK。流式、多轮、函数调用这些按 OpenAI 协议写的逻辑不用改。
- 为什么模型名不是 gpt-4o?
- 平台上提供的是 Gemini 系列模型,走的是兼容协议而不是 OpenAI 的模型。协议兼容、模型不同,model 字段要填平台列表里的 ID。
接着看
照着跑一遍
注册后拿密钥,把示例里的 YOUR_API_KEY 换掉就能跑。