OpenAI API Quickstart

OpenAI 官方 quickstart 现在给出的最短路径，就是直接从 Responses API 发出第一个请求，而不是先研究一堆旧接口。

#Step 1: 创建 API key

先在 OpenAI Platform 里创建 API key，然后立即安全保存。
最稳的方式不是把它写进代码，而是先放到环境变量里。

#Step 2: 设置环境变量

bash复制
# macOS / Linux
export OPENAI_API_KEY="sk-..."

# Windows PowerShell
$env:OPENAI_API_KEY="sk-..."

官方 SDK 默认会从系统环境变量里读取 key。

#Step 3: 发出第一个请求

#Python

python复制
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5",
    input="Write a one-sentence bedtime story about a unicorn."
)

print(response.output_text)

#Node.js

ts复制
import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-5",
  input: "Write a one-sentence bedtime story about a unicorn."
});

console.log(response.output_text);

#curl

bash复制
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": "Say this is a test"
  }'

#第一阶段别急着学太多参数

先只关心三件事：

• key 能不能正常读到
• responses.create() 能不能成功返回
• 你能不能从 response.output_text 拿到结果

只要这三步跑通，后面再加 streaming、tools、structured outputs 都不迟。

#新手最常踩的坑

• 在前端代码里直接写 API key
• 一上来就上最复杂流程，没先做最小请求验证
• 没有记录请求输入输出，出问题时无法复盘

#Related pages

• Authentication
• Chat basics
• Streaming
• OpenAI API overview