开始使用 ↗

接入指南

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 自动重试,便于首次排查;生产环境可设置有限重试和退避,超时请求可能已经产生用量。

继续探索