九关教程全部教程

PYTHON SDK

用 Python 调用

九关提供 OpenAI 兼容地址,可以使用官方 Python SDK。建议把密钥放进环境变量,不要直接写入源代码。

安装 SDK

terminal
python -m pip install --upgrade openai

设置环境变量

Windows PowerShell 当前窗口:

powershell
$env:JIUGUAN_API_KEY="YOUR_API_KEY"

macOS 或 Linux 当前终端:

shell
export JIUGUAN_API_KEY="YOUR_API_KEY"

完整请求

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["JIUGUAN_API_KEY"],
    base_url="https://api.jiuguan.app/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL",
    messages=[
        {"role": "system", "content": "你是一位简洁的中文助手。"},
        {"role": "user", "content": "请介绍一下杭州。"},
    ],
)

print(response.choices[0].message.content)

流式输出

python
stream = client.chat.completions.create(
    model="YOUR_MODEL",
    messages=[{"role": "user", "content": "写一首四行短诗。"}],
    stream=True,
)

for chunk in stream:
    text = chunk.choices[0].delta.content
    if text:
        print(text, end="", flush=True)
不要提交 `.env` 文件

如果你使用 Git,请把保存密钥的文件加入 .gitignore。公开仓库历史中的密钥即使后来删除,也应当视为已经泄露。