SupaStore

返回博客列表

OpenAI API 国内怎么调用?GPT API 中转调用教程(Python / Node.js,2026)

OpenAI API 国内怎么调用?本文用 OpenAI 官方 SDK 演示国内通过中转站调用 GPT API:配置 base_url 与 API Key,用 Chat Completions 和 Responses 两种接口发请求,加上流式输出、Token 用量统计、超时重试,并附 Node.js 示例与常见报错排查。

SupaStore 开发者体验组 ·

OpenAI API 国内怎么调用?GPT API 中转调用教程(Python / Node.js,2026)

OpenAI API 国内调用最稳定的方式,是使用 OpenAI 官方 SDK,把 base_url 换成国内可访问的中转站地址:代码写法和直连官方完全一样,只改一行配置,就能调用 GPT 系列模型,按 Token 用量付费。

这篇 GPT API 调用教程用 Python 和 Node.js 从零演示:安装 SDK、配置 Key、发出第一个请求,再加上流式输出、Token 用量统计和超时重试,每段代码都能直接复制运行。还在挑选服务商的话,可以先看《API中转站是什么?AI中转站选型避坑指南》。


为什么国内调用 OpenAI API 需要中转

国内开发者直接使用 OpenAI 官方 API,通常会遇到三个门槛:

  1. 注册与支付:需要海外手机号和外币信用卡,账号还可能因地区限制无法使用;
  2. 网络:直连容易超时、断流,生产环境很难保证稳定;
  3. 多模型管理:项目里往往还要用 Claude、DeepSeek,分别对接多个平台很麻烦。

API中转站在服务端解决这些问题:你只需要一个 Key 和一个接口地址,用 OpenAI 官方 SDK 就能调用 GPT,也能调用 Claude 等其他模型。


第一步:获取 API Key 和接口地址

  1. 登录 SupaStore,进入【令牌管理】→【添加令牌】;
  2. 勾选要使用的模型(例如 gpt-5.6-luna),并设置额度上限;
  3. 复制 sk- 开头的密钥。

接口地址统一为:

https://api.supastore.cc/v1

建议把 Key 放在环境变量里,不要写进代码:

export OPENAI_API_KEY="sk-your-supastore-api-key"
export OPENAI_BASE_URL="https://api.supastore.cc/v1"

OpenAI 官方 SDK 会自动读取 OPENAI_API_KEY 和 OPENAI_BASE_URL 这两个环境变量。


第二步:Python 调用 OpenAI API

安装 SDK

pip install -U openai

用 Chat Completions 发出第一个请求

from openai import OpenAI

client = OpenAI(
    base_url="https://api.supastore.cc/v1",  # 中转站地址,需带 /v1
    api_key="sk-your-supastore-api-key",     # 已设置环境变量时可省略这两行
)

resp = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[
        {"role": "system", "content": "你是一个简洁的技术助手"},
        {"role": "user", "content": "用一句话解释什么是 API 中转站"},
    ],
)
print(resp.choices[0].message.content)

model 必须填写模型广场中的模型 ID。把它换成 claude-sonnet-4-6,同一段代码就能调用 Claude;调用 DeepSeek 和 Gemini 的写法见《DeepSeek API 怎么调用?》和《Gemini API 国内怎么调用?》。

用 Responses 接口调用

Responses 是 OpenAI 较新的接口,Codex 等工具使用的就是它。SupaStore 同样提供 /v1/responses:

resp = client.responses.create(
    model="gpt-5.6-luna",
    input="用一句话解释什么是 API 中转站",
)
print(resp.output_text)

新项目可以直接用 Responses;已有的 Chat Completions 代码不需要迁移,两种接口都能正常使用。


第三步:流式输出

聊天界面需要边生成边显示时,加上 stream=True:

stream = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

流式输出能让用户更快看到第一个字,长回答时体验明显更好。流式输出的原理和 SSE 事件格式,可以参考《Claude API 流式输出怎么做?》。


第四步:查看 Token 用量

每次响应都带有 usage 字段,可以据此统计成本:

resp = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.usage.prompt_tokens, resp.usage.completion_tokens)

prompt_tokens 是输入 Token,completion_tokens 是输出 Token。按 2026-10-29 模型广场中 gpt-5.6-luna 的默认分组价格(输入 $1、输出 $6 / 百万 Token),一次输入 1,000、输出 500 Token 的请求约 $0.004。Token 的计算方法见《AI Token 是什么?》,实时价格以模型广场为准。


第五步:超时与重试

OpenAI Python SDK 默认会对 429、5xx 和网络错误自动重试 2 次,也可以按需调整:

import openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.supastore.cc/v1",
    max_retries=3,   # 自动重试次数
    timeout=60.0,    # 单次请求超时(秒)
)

try:
    resp = client.chat.completions.create(
        model="gpt-5.6-luna",
        messages=[{"role": "user", "content": "你好"}],
    )
except openai.AuthenticationError:
    print("API Key 无效,检查密钥是否正确")
except openai.RateLimitError:
    print("请求过快或额度不足,稍后重试")
except openai.APIConnectionError:
    print("网络连接失败,检查 base_url 和网络")

Node.js 调用 OpenAI API

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.supastore.cc/v1",
  apiKey: process.env.OPENAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.6-luna",
  messages: [{ role: "user", content: "用一句话解释什么是 API 中转站" }],
});
console.log(resp.choices[0].message.content);

注意 Node.js SDK 的参数名是 baseURL,Python SDK 是 base_url。其他语言和工具的写法见《Base URL 是什么?API Base URL 怎么填》。


先用 cURL 验证接口

写代码之前,可以先在终端确认 Key 和模型可用:

curl https://api.supastore.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model": "gpt-5.6-luna", "messages": [{"role": "user", "content": "Ping"}]}'

返回包含 choices 的 JSON 就说明接口可用。


OpenAI API 国内调用常见报错

现象 常见原因 处理方法
401 Incorrect API key 用了 OpenAI 官方 Key,或密钥复制错误 改用中转站的 Key,并确认 base_url 已生效
404 Not Found base_url 少了 /v1,或多写了 /chat/completions 严格填写 https://api.supastore.cc/v1
模型不存在 模型 ID 拼写错误,或 Key 未勾选该模型 在模型广场核对 ID,检查 Key 的可用模型
429 Too Many Requests 并发过高或额度用完 降低并发、加重试,或调高 Key 额度
连接超时 base_url 仍指向官方地址 检查代码和环境变量里的 base_url

更多错误码的含义见《Claude API 报错怎么办?》,其中 401、429 的处理思路同样适用于 OpenAI API。


常见问题 (FAQ)

Q: 用中转站调用 OpenAI API,需要 OpenAI 官方账号吗?

答: 不需要。中转站提供自己的 Key 和接口地址,请求由中转站转发到上游,不需要 OpenAI 账号、海外手机号或外币信用卡。

Q: 一个 Key 能同时调用 GPT 和 Claude 吗?

答: 可以。在同一个 OpenAI SDK 客户端里,把 model 换成 claude-sonnet-4-6 就能调用 Claude。想同时管理多家模型,可以参考《如何通过单 API Key 统一接入 40+ 主流大模型》。

Q: Chat Completions 和 Responses 该用哪个?

答: 已有项目继续用 Chat Completions 即可,生态最成熟;新项目或需要接入 Codex 这类工具时,可以使用 Responses。Codex 的配置见《Codex CLI 怎么配置中转 API?》。

Q: 中转站调用 OpenAI API 安全吗?

答: 取决于你选的服务商。请求内容会经过中转站,建议选择不存储对话内容、计费透明、能逐条查看日志的服务商,并给每个 Key 设置额度上限。