OpenAI API 快速开始：Python Responses 调用

中文实战指南 · 核验于 2026-11-14

这份指南用官方 Python SDK 说明一次文本请求。需要 Python 环境、可以访问 API 的项目凭据，以及对目标模型的访问权限；本文未使用真实账号发送付费请求。

准备运行环境

为示例创建独立环境并安装官方 SDK：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install openai

这是 macOS / Linux shell 示例；Windows 的环境激活命令不同。JavaScript 等语言的库与对应示例请从官方快速开始选择，不把 Python 的参数写法直接复制到其他 SDK。

在应用运行环境设置 OPENAI_API_KEY 和 OPENAI_MODEL。前者是项目凭据，后者填写账号实际可用、符合任务的模型 ID。密钥由服务端环境保管，不放到浏览器源码、文档或 Git。

发出最小请求

将下面片段保存为 example.py。模型 ID 由环境提供，避免示例长期绑定一个型号：

import os

from openai import OpenAI


def main() -> None:
    if not os.environ.get("OPENAI_API_KEY"):
        raise SystemExit("OPENAI_API_KEY is required")
    model = os.environ.get("OPENAI_MODEL")
    if not model:
        raise SystemExit("OPENAI_MODEL is required")
    client = OpenAI()
    response = client.responses.create(
        model=model,
        input="Explain what an API is in one short paragraph.",
    )
    print(response.output_text)


if __name__ == "__main__":
    main()

运行 python example.py，确认收到与输入相关的文本。缺失环境变量会在请求前给出明确错误；请求失败时 SDK 会抛出异常，调用方应按 错误分类 决定如何处理，不要吞掉异常后输出成功。

接进业务前检查

最小示例不包含生产系统所需的请求预算、业务日志和重试策略。先用可接受的样本检查输出，再记录调用耗时、错误类型和业务结果，避免记录密钥或不必要的敏感输入。

下一步阅读 模型选择；遇到 401 或 429 时按错误体排查，不要只替换模型名称。