接入指南
OpenAI Python SDK 接入指南
使用 OpenAI Python SDK 接入 ZHUAN:保留熟悉的消息结构,将 base_url 设置为 ZHUAN 地址,并使用本站生成的 API Key 和准确 Model ID。
安装与准备
先完成充值并生成有效 Key,将其保存到 ZHUAN_API_KEY 环境变量。安装 OpenAI Python SDK;已有项目可以保留现有依赖,升级前先在开发环境确认兼容性。
python -m pip install openai
最小文本请求
base_url 填写 https://key.zhuan.xyz/v1,不要重复追加 /chat/completions。下面的 GPT 示例使用目录中的完整 ID;更换模型时,先检查当前目录和该模型支持的接口。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ZHUAN_API_KEY"],
base_url="https://key.zhuan.xyz/v1",
timeout=60.0,
max_retries=0,
)
response = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)
流式返回
沿用上面创建的 client,把 stream 设置为 True,并逐段读取 delta。部分事件没有正文,输出前检查 choices 和 content。流式连接需要客户端持续读取,主动中断并不保证已产生的用量不计费。
with client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Hello"}],
stream=True,
) as stream:
for chunk in stream:
if chunk.choices:
print(chunk.choices[0].delta.content or "", end="", flush=True)
迁移和错误处理
- 将 API 地址、Key 和模型 ID 一起检查;厂商账户的 Key 不能替代本站 Key。
- Chat Completions、Responses 和各模型参数并非完全相同;按具体接口逐项验证,不要假设所有模型接受同一组参数。
- 示例关闭 SDK 自动重试,便于首次排查;生产环境可设置有限重试和退避,超时请求可能已经产生用量。