Python SDK

OpenAI Python SDK 可以通过自定义 base_url 连接豆子 API。以下代码适合本机脚本或应用后端。

安装

在项目虚拟环境中安装依赖：

python -m pip install openai

设置密钥

Windows PowerShell

$env:BEANC_API_KEY = "YOUR_API_KEY_HERE"

macOS / Linux

export BEANC_API_KEY="YOUR_API_KEY_HERE"

这些命令对当前终端会话生效。把占位符换成自己的密钥，运行脚本时使用同一个终端。

发送文本请求

保存为 main.py，替换模型 ID，然后运行 python main.py。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BEANC_API_KEY"],
    base_url="https://api.beanc.cn/v1",
    timeout=60.0,
    max_retries=0,
)

completion = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "你好，豆子！"}],
)
print(completion.choices[0].message.content)

示例关闭 SDK 自动重试，便于初次排查时把一次执行与一条请求对应起来。生产应用可根据错误类型设置有限重试；超时不能证明上游没有执行。

流式与异步

逐段显示回答见流式输出。并发应用也可使用 SDK 的 AsyncOpenAI，但应根据账号和渠道限制控制并发量。

常见问题

• 找不到 BEANC_API_KEY：先在启动脚本的终端设置环境变量。
• 出现 /v1/v1：检查 base_url 与应用中额外拼接的路径。
• 返回模型不可用：复制控制台完整 ID，核对分组和接口支持。

官方参考：OpenAI Python API library，“Retries / Timeouts / Configuring the HTTP client”；Chat Completions Reference，请求与返回。