OpenAI SDK 自定义 Base URL：Python 与 Node.js 示例

选一种语言，完成一次最小请求

1. 1

   安装所用语言的 SDK 并记录版本。不要在生产环境无记录地自动升级；SDK 提供的方法不代表当前模型或分组已支持对应端点。

   安装与版本记录

   复制示例

   复制后合并到自己的配置；请在本地安全设置真实凭据。

   python -m pip install openai
   python -m pip show openai
   
   npm install openai
   npm ls openai

2. 2

   Python 使用 base_url、timeout（秒）与 max_retries。下面发起一次非流式 Chat 请求，读取有效文本与结束原因；timeout=60.0 只是本示例的排查设置，长任务按项目调整。

   tokenba_sdk.py

   复制示例

   复制后合并到自己的配置；请在本地安全设置真实凭据。

   import os
   from openai import OpenAI
   
   client = OpenAI(
       api_key=os.environ["tokenba_API_KEY"],
       base_url="https://api.apizt.com/v1",
       timeout=60.0,
       max_retries=0,
   )
   response = client.chat.completions.create(
       model=os.environ["tokenba_MODEL"],
       messages=[{"role": "user", "content": "请只回复：连接测试成功"}],
       stream=False,
   )
   if not response.choices or not response.choices[0].message.content:
       raise RuntimeError("未取得有效文本，请核对响应与模型能力")
   if response.choices[0].finish_reason != "stop":
       raise RuntimeError("响应未完整结束，请保留回执检查")
   print(response.choices[0].message.content)
   print("model:", response.model)
   print("usage:", response.usage)
   print("finish_reason:", response.choices[0].finish_reason)

3. 3

   Node.js 使用 baseURL、timeout（毫秒）与 maxRetries。基础地址必须包含 /v1，不能误填根域或 /chat/completions 完整路径。运行 node tokenba_sdk.mjs 时，将凭据注入同一进程环境。

   tokenba_sdk.mjs

   复制示例

   复制后合并到自己的配置；请在本地安全设置真实凭据。

   import OpenAI from "openai";
   
   const apiKey = process.env.tokenba_API_KEY;
   const model = process.env.tokenba_MODEL;
   if (!apiKey || !model) throw new Error("请在启动环境设置 API Key 和准确模型 ID");
   
   const client = new OpenAI({
     apiKey,
     baseURL: "https://api.apizt.com/v1",
     timeout: 60_000,
     maxRetries: 0,
   });
   const response = await client.chat.completions.create({
     model,
     messages: [{ role: "user", content: "请只回复：连接测试成功" }],
     stream: false,
   });
   const choice = response.choices[0];
   if (!choice?.message.content) throw new Error("未取得有效文本，请核对响应与模型能力");
   if (choice.finish_reason !== "stop") throw new Error("响应未完整结束，请保留回执检查");
   console.log(choice.message.content)
   console.log("model:", response.model);
   console.log("usage:", response.usage);
   console.log("finish_reason:", choice.finish_reason);

4. 4

   默认 SDK 可能自动重试部分失败。本示例显式关闭自动重试，便于观察一次调用；上线时结合状态码和 Retry-After 设置有限重试，避免 SDK、框架和业务层叠加。超时或断连不代表上游一定未执行，后台用量仍要核对。

5. 5

   用 Chat 示例验收后，再考虑 Responses 或 Anthropic Messages。Chat 使用 messages / choices；Responses 使用 input / output；Messages 有自己的内容块与工具字段。地址正确不会自动完成请求体和返回结构转换。

   协议与完整端点

   复制示例

   复制后合并到自己的配置；请在本地安全设置真实凭据。

   Chat Completions: https://api.apizt.com/v1/chat/completions
   Responses: https://api.apizt.com/v1/responses
   Anthropic Messages: https://api.apizt.com/v1/messages

6. 6

   记录有效输出、结束状态与后台请求；失败时捕获 SDK 异常中的状态码、错误类型和可用 request ID，保留脱敏信息。网络异常可能没有 HTTP 状态，网关或上游错误也不能假定都与 OpenAI 官方完全同形。

7. 7

   按项目逐项测试流式、工具回路、结构化输出和图片输入。Embedding / Rerank 使用独立任务与验收资料；Go、Spring AI 和 Agent 的参数、默认协议与上下文管理需要按各框架分别配置。