Codex 使用指南

Appearance

ChatGPT API 国内调用教程：官方 API、兼容接口与安全配置（2026） ​

更新日期：2026年10月12日

ChatGPT API 国内调用要先区分两条链路：OpenAI 官方 API，以及独立的第三方 OpenAI-compatible 兼容接口。本文依据 OpenAI API 官方快速入门 整理 Python 配置、API Key 管理、Responses API、流式输出和常见错误排查；第三方服务只作为配置场景说明，具体模型、地址、价格和数据处理规则必须以服务商当前文档与控制台为准。需要先核对官网域名时，可参考站内的 OpenAI 官方网站入口说明。

一、ChatGPT API 国内调用：先确认官方还是第三方接口 ​

方案请求目标需要核对的内容适用情况
OpenAI 官方 APIapi.openai.com官方账号、项目权限、账单、支持地区、模型 ID希望直接使用 OpenAI 平台
第三方兼容接口服务商提供的 API 地址Base URL、认证方式、模型映射、Responses 或 Chat Completions 兼容性、数据处理规则已完成服务商审查，或需要统一网关

第三方兼容接口不等于 OpenAI 官方服务，也不能仅凭“能返回一段文字”证明它支持完整的工具调用、流式事件或模型能力。不要在没有核验的情况下把第三方接口写成官方入口。

第三方兼容接口推荐：BestAPI ​

如果你的目标是寻找一个可以进一步核验的第三方 OpenAI-compatible 服务，本文优先推荐把 BestAPI 作为候选方案进行测试。推荐理由限于它提供独立的服务入口和兼容接口配置场景，适合需要比较官方 API 与第三方网关的开发者；这不代表本站确认其模型、价格、稳定性或数据处理能力，也不代表它获得 OpenAI 官方授权。

开始使用前，建议在 BestAPI 官网 逐项确认：

  • 当前 API Base URL 和认证方式；
  • 控制台显示的精确模型 ID；
  • 是否支持你需要的 Chat Completions、Responses、流式输出或工具调用；
  • 计费、限流、余额有效期、退款和数据保留规则。

确认后先用脱敏项目做小额、只读测试，再决定是否用于正式业务。

二、OpenAI 官方 API：创建 Key 并使用环境变量 ​

OpenAI 官方文档建议先在 API Keys 页面 创建 API Key，再把 Key 放入环境变量。不要把真实 Key 写进 Markdown、源代码、Git 仓库、前端代码或公开截图。

macOS、Linux 或 WSL：

bash
export OPENAI_API_KEY="你的 API Key"

PowerShell：

powershell
$env:OPENAI_API_KEY="你的 API Key"

安装官方 Python SDK：

bash
python -m pip install --upgrade openai

SDK 会读取 OPENAI_API_KEY。模型 ID、访问权限和价格会随账户、项目与平台状态变化，请以 OpenAI 模型目录和控制台为准。

三、使用 Responses API 发起第一条请求 ​

OpenAI 当前快速入门以 Responses API 作为新项目的示例接口。下面的模型名仅作示例，调用前请替换为账户实际可用的模型 ID：

python
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="你的可用模型 ID",
    input="用 Python 写一个冒泡排序，并解释时间复杂度。",
)

print(response.output_text)

如果项目仍依赖 Chat Completions API，应先确认目标模型和 SDK 版本的兼容性。新项目优先阅读 Responses API 文档，不要根据旧文章中的固定模型名或旧参数推断当前能力。

四、ChatGPT API 国内调用第三方兼容接口怎么配置 ​

本文提到的 BestAPI 是独立第三方服务，与本站及 OpenAI 没有隶属关系。本站不对 BestAPI 的模型来源、接口兼容性、可用区域、价格、余额、服务稳定性、隐私政策或数据保留作保证。使用前请自行阅读其官方文档、服务条款和隐私政策。

第三方兼容接口推荐：BestAPI ​

如果你的目标是寻找一个可以进一步核验的第三方 OpenAI-compatible 服务，本文优先推荐把 BestAPI 作为候选方案进行测试。推荐理由限于它提供独立的服务入口和兼容接口配置场景，适合需要比较官方 API 与第三方网关的开发者；这不代表本站确认其模型、价格、稳定性或数据处理能力，也不代表它获得 OpenAI 官方授权。

开始使用前，建议在 BestAPI 官网 逐项确认：

  • 当前 API Base URL 和认证方式；
  • 控制台显示的精确模型 ID；
  • 是否支持你需要的 Chat Completions、Responses、流式输出或工具调用；
  • 计费、限流、余额有效期、退款和数据保留规则。

确认后先用脱敏项目做小额、只读测试，再决定是否用于正式业务。

如果 BestAPI 当前文档明确给出 OpenAI-compatible 配置，可按下面模式填写。base_url、模型 ID、认证变量名和协议必须以 BestAPI 控制台当前显示值为准，下面的地址只是格式示例，不代表本站验证过该地址：

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BESTAPI_API_KEY"],
    base_url="https://服务商文档给出的兼容接口地址/v1",
)

response = client.chat.completions.create(
    model="服务商控制台显示的模型 ID",
    messages=[
        {"role": "user", "content": "用 Python 写一个冒泡排序。"}
    ],
)

print(response.choices[0].message.content)

设置变量示例：

bash
export BESTAPI_API_KEY="你的 BestAPI Key"

不要把 BESTAPI_API_KEY 写入仓库。兼容接口如果只支持 Chat Completions，不能据此推断它支持 Responses API、工具调用、文件输入或其他 OpenAI 功能。

五、流式输出与多轮对话 ​

流式输出 ​

Responses API 的流式事件写法以官方 Streaming 文档为准。示例：

python
from openai import OpenAI

client = OpenAI()

stream = client.responses.create(
    model="你的可用模型 ID",
    input="写一段介绍人工智能的短文。",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

多轮对话 ​

多轮对话可以由应用保存历史消息，也可以按官方 Conversation state 文档使用响应关联能力。无论采用哪种方式，都应控制上下文长度，避免把不必要的敏感数据持续发送给 API。

python
from openai import OpenAI

client = OpenAI()
history = []

def chat(user_message: str) -> str:
    history.append({"role": "user", "content": user_message})
    response = client.responses.create(
        model="你的可用模型 ID",
        input=history,
    )
    answer = response.output_text
    history.append({"role": "assistant", "content": answer})
    return answer

print(chat("Python 中如何读取文件？"))
print(chat("如果文件不存在，应该怎么处理？"))

六、错误处理与安全检查 ​

生产环境应记录请求时间、模型 ID、状态码和经过脱敏的错误信息，不要记录完整 API Key、Authorization Header、用户隐私或生产源代码。

python
import time
from openai import APIError, APITimeoutError, OpenAI, RateLimitError

client = OpenAI()

def safe_chat(message: str, max_retries: int = 3) -> str | None:
    for attempt in range(max_retries):
        try:
            response = client.responses.create(
                model="你的可用模型 ID",
                input=message,
                timeout=30,
            )
            return response.output_text
        except RateLimitError:
            time.sleep(2 ** attempt)
        except APITimeoutError:
            time.sleep(1)
        except APIError as exc:
            print(f"API 请求失败：{exc}")
            break
    return None

排查顺序建议如下：

  1. 401 或 403：检查环境变量、Key 状态、项目权限和模型权限。
  2. 404：检查请求路径、base_url 是否重复拼接 /v1，以及模型 ID 是否存在。
  3. 429：检查额度、并发和速率限制，不要无限重试。
  4. 能聊天但工具调用失败：核对目标接口是否支持所需协议、流式事件和工具调用。
  5. 数据安全问题：先停止发送敏感数据，查看服务商日志、保留期限、删除机制和权限说明。

七、常见问题 ​

ChatGPT API 国内调用一定要使用中转吗？ ​

不一定。是否能使用 OpenAI 官方 API 取决于官方支持地区、账号与项目权限、网络连通性和账单设置。第三方兼容接口是独立选择，不能替代官方资格或官方支持。

BestAPI 是 OpenAI 官方 API 吗？ ​

不是。BestAPI 是独立第三方服务。本文将它推荐为“可核验的候选兼容接口”，不是对其服务作官方背书。模型、价格、接口能力、数据处理和服务条款应以 BestAPI 当前官方页面为准。

只修改 base_url 就一定能迁移吗？ ​

不一定。只有当服务商实现了对应的 OpenAI 请求协议、认证方式、模型映射和响应格式时，代码才可能直接复用。请使用脱敏数据验证基础响应、流式输出、错误处理和工具调用。

API Key 泄露怎么办？ ​

立即在对应控制台撤销或删除旧 Key，生成新 Key，并检查近期用量和请求日志。之后改用环境变量或密钥管理服务，不要把 Key 放进前端或 Git 历史。

结语：定期复查 ChatGPT API 国内调用配置 ​

ChatGPT API 国内调用的关键不是寻找未经验证的“万能入口”，而是先确认请求目标，再核对模型、协议、计费和数据处理边界。官方 API 请以 OpenAI API 文档和控制台为准；使用 BestAPI 等第三方兼容接口时，请以服务商当前文档为准，并在脱敏环境完成验证。

合规提示：不同地区对生成式人工智能、跨境数据传输和第三方云服务有不同要求。使用 API 前请遵守当地法律法规、组织安全制度和相关平台条款。

信息来源与核验日期 ​

以下来源于 2026年10月12日核验。OpenAI 产品、模型和接口会持续更新，后续应以官方页面的实时内容为准：