客户端接入

OpenAI SDK

Python 与 Node.js 的 base_url 和认证

Base URL 与环境变量

Python 的 base_url 和 Node.js 的 baseURL 均填写 https://www.yunqiai.chat/v1。SDK 自动追加 /responses 或 /chat/completions，不再重复添加 /v1。

设置 YUNQIAI_API_KEY 和 YUNQIAI_MODEL 后即可调用。以下示例使用 Responses，请填写支持该协议的模型 ID。

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YUNQIAI_API_KEY"],
    base_url="https://www.yunqiai.chat/v1",
    max_retries=0,
    timeout=300.0,
)
response = client.responses.create(
    model=os.environ["YUNQIAI_MODEL"],
    input="仅回复 READY",
    max_output_tokens=2048,
)
if response.status != "completed" or not response.output_text:
    raise RuntimeError("Response did not contain a completed text answer")
print(response.output_text)

javascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YUNQIAI_API_KEY,
  baseURL: "https://www.yunqiai.chat/v1",
  maxRetries: 0,
  timeout: 300000,
});
const response = await client.responses.create({
  model: process.env.YUNQIAI_MODEL,
  input: "仅回复 READY",
  max_output_tokens: 2048,
});
if (response.status !== "completed" || !response.output_text) {
  throw new Error("Response did not contain a completed text answer");
}
console.log(response.output_text);

Python 使用 python -m pip install openai 安装，Node.js 使用 npm install openai。项目应锁定 SDK 版本，升级后检查请求字段和响应解析是否仍兼容。

协议差异

Chat 使用 client.chat.completions.create，输入为 messages，输出为 choices。Responses 使用 client.responses.create，输入为 input，输出为 output。切换协议时，请同时调整请求和响应处理。

示例已关闭 SDK 自动重试，重试逻辑由应用按错误处理控制，以免重复提交生成请求。遇到“连接失败”时，先检查请求 URL、代理、证书和 DNS。