开放能力导航
首页/OpenAI API/调用手册
OpenAI API调用手册

使用 Responses 生成文本

提交一段业务文字，得到简明摘要，并识别实际文本输出。

官方资料核对 2026-10-15示例代码，未进行真实接口实测
← 返回平台功能

接入准备

  • 项目 API Key 可写入 Responses；账号具备示例模型使用权限及可用账单。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

OPENAI_API_KEY
在 API 平台的目标项目中创建的密钥；仅放自己的服务端环境变量。
终端
export OPENAI_API_KEY='replace_with_project_api_key'

以上 export 适用于 macOS / Linux 的终端，在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

  1. 01

    登录 OpenAI API 平台，创建或选择项目；确认组织、地区资格、模型权限和 API 账单可用。ChatGPT 订阅不代替 API 账单。

  2. 02

    在目标项目的 API keys 页面创建密钥；若使用受限密钥，授予下方目标端点的写入权限。复制后在自己的服务端设置 OPENAI_API_KEY。

  3. 03

    核对请求里的模型名、输入内容和输出上限，再运行代码。本网站不会代收密钥或向 OpenAI 发起请求。

调用 01

生成一段摘要

input 为普通文字；store=false 不保存用于后续检索的 Response 对象，但不等于账户启用了零数据保留。

POSThttps://api.openai.com/v1/responses

请求头

Authorization
Bearer ${OPENAI_API_KEY}
Content-Type
application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置类型 / 必填说明
model请求体string必填本例 gpt-6.1-sol，调用前确认自己项目可以访问。
instructions请求体string可选本次请求的生成要求；本例要求用中文给出一句摘要。
input请求体string必填待处理内容，也可使用接口支持的消息数组。
max_output_tokens请求体integer可选本例 1024；是上限，不保证固定长度，推理 Token 也可能计入。
store请求体boolean可选本例 false；不要把它等同于数据保留、日志或合规策略的全部配置。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

cURL
cat > request-body.json <<'JSON'
{
  "model": "gpt-6.1-sol",
  "instructions": "用一句中文概括用户给出的内容。",
  "input": "这周完成了登录页面和接口联调，下周开始测试支付通知。",
  "max_output_tokens": 1024,
  "store": false
}
JSON

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.openai.com/v1/responses" \
  --header "Authorization: Bearer ${OPENAI_API_KEY}" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.openai.com/v1/responses")
headers = {
    "Authorization": expand("Bearer ${OPENAI_API_KEY}"),
    "Content-Type": expand("application/json"),
}
body = {
    "model": "gpt-6.1-sol",
    "instructions": "用一句中文概括用户给出的内容。",
    "input": "这周完成了登录页面和接口联调，下周开始测试支付通知。",
    "max_output_tokens": 1024,
    "store": False,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
Node.js
// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.openai.com/v1/responses");
const headers = Object.fromEntries(
  Object.entries({
  "Authorization": "Bearer ${OPENAI_API_KEY}",
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "model": "gpt-6.1-sol",
  "instructions": "用一句中文概括用户给出的内容。",
  "input": "这周完成了登录页面和接口联调，下周开始测试支付通知。",
  "max_output_tokens": 1024,
  "store": false
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

按官方字段整理的响应结构示意，ID、文本和数字均为虚构，非接口实测结果。原始 HTTP 响应应遍历 output 中 type=message 的 content，再取 type=output_text 的 text，不能假设第一项必为正文。 以下为结构示意，非本站实测结果。

JSON
{
  "id": "resp_example_not_real",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "这是一段虚构的摘要结果。",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 30,
    "output_tokens": 16,
    "total_tokens": 46
  }
}

常见错误与排查

HTTP 401密钥认证失败。
核对环境变量值、项目归属与密钥状态；重新生成已撤销或无效的密钥。
HTTP 403调用身份或所在地区不被允许使用该资源。
检查模型和项目权限、支持地区及账号验证要求。
HTTP 429请求过快、余额耗尽或组织/项目用量上限触发，原因并不相同。
读取 error.code；限流按 Retry-After 退避，余额或支出限制需在账单/项目中处理，不能靠快速重试解决。

调用注意

  • HTTP 200 后还要检查 status 是否 completed；incomplete、refusal 和工具调用需分别处理。
  • SDK 的 output_text 是便捷聚合字段；本页使用原始 HTTP，请按 output 数组结构解析。
Responses 文本生成与原始输出读取Create a model responseOpenAI HTTP 错误及排查

注意事项

  • 本例使用 gpt-6.1-sol 的标准文本调用，核验日每百万未缓存输入 Token 2 美元、输出 Token 10 美元；缓存、长上下文和其他处理模式另有规则。
  • 示例未启用收费工具或外部检索。限流按组织、项目和模型计算，以项目 Limits 为准；返回 usage 才是本次用量依据。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
  2. 02
    GPT-6.1 Sol 模型能力和价格核验日期 2026-10-15
  3. 03
  4. 04
  5. 05
    Create a model response核验日期 2026-10-15
  6. 06
    OpenAI HTTP 错误及排查核验日期 2026-10-15

OpenAI API的其他调用手册

把文字提取成固定 JSON 字段生成文本检索向量

← 返回OpenAI API的全部功能