教程 / 接入

用 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 换掉就能跑。

免费注册