OpenAI Responses API — Text Generation

OpenAI 官方文本生成指南展示 Responses HTTP API，以模型和输入生成文本或结构化内容；需 Bearer API key，输出可能含多类条目，本次未调用。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-f8536bb7406e17273f32dba4
Card version: 2
Updated: 2026-10-24T17:49:47.4498609+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

本次官方 Text generation 指南提供 https://api.openai.com/v1/responses 的 JSON 请求示例，以及多语言 SDK 等价示例。可提交 model、input，并用 instructions 或带角色的消息指定行为；部分示例包含 reasoning.effort。响应的 output 是条目数组，可含文本、工具调用和推理相关内容；部分官方 SDK 提供聚合文本的 output_text 便利属性。这里只整理指南已给出的文档契约，不表示当前已连接账户、获准使用示例模型或执行工具。

Inputs

model：调用方可访问的模型标识。
input：文本提示，或包含 developer/user 等角色的输入消息。
可选 instructions 为本次请求设置行为指令；部分示例使用 reasoning.effort。

Outputs

响应 output 为生成条目数组，可包括 assistant message/content 的 output_text 条目、工具调用或推理相关条目。
适用官方 SDK 的 output_text 属性聚合模型文本；不应假定纯文本固定在 output[0].content[0].text。
正文提及 Structured Outputs 可生成 JSON 结构，完整配置未由此指南段落展开。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u6B63\u6587 cURL \u793A\u4F8B\u5305\u542B Authorization: Bearer $OPENAI_API_KEY\uFF1BSDK \u793A\u4F8B\u4E5F\u4ECE\u73AF\u5883\u53D6\u5F97 API key\u3002\u5B9E\u9645\u8D26\u6237\u3001key \u6743\u9650\u548C\u53EF\u7528\u6A21\u578B\u672A\u9A8C\u8BC1\u3002"
  },
  "command": null,
  "entry_url": "https://api.openai.com/v1/responses",
  "kind": "http_api",
  "method": "POST",
  "request_example": {
    "documentation_text": "\u6587\u6863\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1APOST https://api.openai.com/v1/responses\uFF1BContent-Type: application/json\uFF1BAuthorization: Bearer \u003COPENAI_API_KEY\u003E\uFF1BJSON \u542B model \u4E0E input \u6587\u672C\u3002"
  },
  "requirements": [
    "\u8C03\u7528\u65B9\u81EA\u884C\u63D0\u4F9B\u6709\u6548 OpenAI API key \u548C\u53EF\u8BBF\u95EE\u7684 model\u3002",
    "\u4EE5 JSON \u63D0\u4EA4 model \u4E0E input\uFF1B\u53EF\u6309\u6587\u6863\u52A0\u5165 instructions \u6216\u89D2\u8272\u6D88\u606F\u3002",
    "\u6309\u5B9E\u9645 output \u6761\u76EE\u7C7B\u578B\u89E3\u6790\u7ED3\u679C\uFF0C\u6216\u4F7F\u7528\u9002\u7528 SDK \u7684 output_text \u805A\u5408\u5C5E\u6027\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u672C\u6B21\u6307\u5357\u6B63\u6587\u672A\u63D0\u4F9B\u5177\u4F53\u5355\u4EF7\u3001\u514D\u8D39\u989D\u5EA6\u3001\u901F\u7387\u9650\u5236\u6216\u914D\u989D\uFF1B\u5BFC\u822A\u4E2D\u7684 Pricing \u94FE\u63A5\u4E0D\u6784\u6210\u5DF2\u8BFB\u53D6\u7684\u4EF7\u683C\u8BC1\u636E\u3002",
  "source_url": "https://developers.openai.com/api/docs/guides/text"
}

{
  "location": "provider_server",
  "notes": "\u8F93\u5165\u6587\u672C\u3001\u6307\u4EE4\u548C\u53C2\u6570\u53D1\u9001\u5230 OpenAI \u6258\u7BA1 API\uFF1B\u672C\u6B21\u6B63\u6587\u672A\u786E\u8BA4\u5177\u4F53\u6570\u636E\u4FDD\u5B58\u3001\u8BAD\u7EC3\u7528\u9014\u6216\u9A7B\u7559\u653F\u7B56\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

模型生成具有非确定性，不同模型或快照的提示行为可能不同。
instructions 只适用于当前响应；使用 previous_response_id 时，先前 instructions 不会自动出现在后续上下文。
工具调用输出不等于工具已由服务或调用方实际运行。
本次只核文本生成指南，不扩展为侧栏列出的所有模型、工具或产品能力。

Unknowns

账户开通、有效 API key 权限和可用模型未知。
当前绝对单价、免费额度、速率限制和配额未知。
数据保留、训练用途及驻留条件未由本次正文确认。
未执行请求、生成内容、运行 SDK/CLI 示例或调用工具。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:45:07.7921938\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developers.openai.com/api/docs/guides/text"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u8F93\u5165\u6587\u672C\u3001\u6307\u4EE4\u548C\u53C2\u6570\u53D1\u9001\u5230 OpenAI \u6258\u7BA1 API\uFF1B\u672C\u6B21\u6B63\u6587\u672A\u786E\u8BA4\u5177\u4F53\u6570\u636E\u4FDD\u5B58\u3001\u8BAD\u7EC3\u7528\u9014\u6216\u9A7B\u7559\u653F\u7B56\u3002"
  },
  "description": "\u672C\u6B21\u5B98\u65B9 Text generation \u6307\u5357\u63D0\u4F9B https://api.openai.com/v1/responses \u7684 JSON \u8BF7\u6C42\u793A\u4F8B\uFF0C\u4EE5\u53CA\u591A\u8BED\u8A00 SDK \u7B49\u4EF7\u793A\u4F8B\u3002\u53EF\u63D0\u4EA4 model\u3001input\uFF0C\u5E76\u7528 instructions \u6216\u5E26\u89D2\u8272\u7684\u6D88\u606F\u6307\u5B9A\u884C\u4E3A\uFF1B\u90E8\u5206\u793A\u4F8B\u5305\u542B reasoning.effort\u3002\u54CD\u5E94\u7684 output \u662F\u6761\u76EE\u6570\u7EC4\uFF0C\u53EF\u542B\u6587\u672C\u3001\u5DE5\u5177\u8C03\u7528\u548C\u63A8\u7406\u76F8\u5173\u5185\u5BB9\uFF1B\u90E8\u5206\u5B98\u65B9 SDK \u63D0\u4F9B\u805A\u5408\u6587\u672C\u7684 output_text \u4FBF\u5229\u5C5E\u6027\u3002\u8FD9\u91CC\u53EA\u6574\u7406\u6307\u5357\u5DF2\u7ED9\u51FA\u7684\u6587\u6863\u5951\u7EA6\uFF0C\u4E0D\u8868\u793A\u5F53\u524D\u5DF2\u8FDE\u63A5\u8D26\u6237\u3001\u83B7\u51C6\u4F7F\u7528\u793A\u4F8B\u6A21\u578B\u6216\u6267\u884C\u5DE5\u5177\u3002",
  "inputs": [
    "model\uFF1A\u8C03\u7528\u65B9\u53EF\u8BBF\u95EE\u7684\u6A21\u578B\u6807\u8BC6\u3002",
    "input\uFF1A\u6587\u672C\u63D0\u793A\uFF0C\u6216\u5305\u542B developer/user \u7B49\u89D2\u8272\u7684\u8F93\u5165\u6D88\u606F\u3002",
    "\u53EF\u9009 instructions \u4E3A\u672C\u6B21\u8BF7\u6C42\u8BBE\u7F6E\u884C\u4E3A\u6307\u4EE4\uFF1B\u90E8\u5206\u793A\u4F8B\u4F7F\u7528 reasoning.effort\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u6B63\u6587 cURL \u793A\u4F8B\u5305\u542B Authorization: Bearer $OPENAI_API_KEY\uFF1BSDK \u793A\u4F8B\u4E5F\u4ECE\u73AF\u5883\u53D6\u5F97 API key\u3002\u5B9E\u9645\u8D26\u6237\u3001key \u6743\u9650\u548C\u53EF\u7528\u6A21\u578B\u672A\u9A8C\u8BC1\u3002"
    },
    "command": null,
    "entry_url": "https://api.openai.com/v1/responses",
    "kind": "http_api",
    "method": "POST",
    "request_example": {
      "documentation_text": "\u6587\u6863\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1APOST https://api.openai.com/v1/responses\uFF1BContent-Type: application/json\uFF1BAuthorization: Bearer \u003COPENAI_API_KEY\u003E\uFF1BJSON \u542B model \u4E0E input \u6587\u672C\u3002"
    },
    "requirements": [
      "\u8C03\u7528\u65B9\u81EA\u884C\u63D0\u4F9B\u6709\u6548 OpenAI API key \u548C\u53EF\u8BBF\u95EE\u7684 model\u3002",
      "\u4EE5 JSON \u63D0\u4EA4 model \u4E0E input\uFF1B\u53EF\u6309\u6587\u6863\u52A0\u5165 instructions \u6216\u89D2\u8272\u6D88\u606F\u3002",
      "\u6309\u5B9E\u9645 output \u6761\u76EE\u7C7B\u578B\u89E3\u6790\u7ED3\u679C\uFF0C\u6216\u4F7F\u7528\u9002\u7528 SDK \u7684 output_text \u805A\u5408\u5C5E\u6027\u3002"
    ]
  },
  "limitations": [
    "\u6A21\u578B\u751F\u6210\u5177\u6709\u975E\u786E\u5B9A\u6027\uFF0C\u4E0D\u540C\u6A21\u578B\u6216\u5FEB\u7167\u7684\u63D0\u793A\u884C\u4E3A\u53EF\u80FD\u4E0D\u540C\u3002",
    "instructions \u53EA\u9002\u7528\u4E8E\u5F53\u524D\u54CD\u5E94\uFF1B\u4F7F\u7528 previous_response_id \u65F6\uFF0C\u5148\u524D instructions \u4E0D\u4F1A\u81EA\u52A8\u51FA\u73B0\u5728\u540E\u7EED\u4E0A\u4E0B\u6587\u3002",
    "\u5DE5\u5177\u8C03\u7528\u8F93\u51FA\u4E0D\u7B49\u4E8E\u5DE5\u5177\u5DF2\u7531\u670D\u52A1\u6216\u8C03\u7528\u65B9\u5B9E\u9645\u8FD0\u884C\u3002",
    "\u672C\u6B21\u53EA\u6838\u6587\u672C\u751F\u6210\u6307\u5357\uFF0C\u4E0D\u6269\u5C55\u4E3A\u4FA7\u680F\u5217\u51FA\u7684\u6240\u6709\u6A21\u578B\u3001\u5DE5\u5177\u6216\u4EA7\u54C1\u80FD\u529B\u3002"
  ],
  "outputs": [
    "\u54CD\u5E94 output \u4E3A\u751F\u6210\u6761\u76EE\u6570\u7EC4\uFF0C\u53EF\u5305\u62EC assistant message/content \u7684 output_text \u6761\u76EE\u3001\u5DE5\u5177\u8C03\u7528\u6216\u63A8\u7406\u76F8\u5173\u6761\u76EE\u3002",
    "\u9002\u7528\u5B98\u65B9 SDK \u7684 output_text \u5C5E\u6027\u805A\u5408\u6A21\u578B\u6587\u672C\uFF1B\u4E0D\u5E94\u5047\u5B9A\u7EAF\u6587\u672C\u56FA\u5B9A\u5728 output[0].content[0].text\u3002",
    "\u6B63\u6587\u63D0\u53CA Structured Outputs \u53EF\u751F\u6210 JSON \u7ED3\u6784\uFF0C\u5B8C\u6574\u914D\u7F6E\u672A\u7531\u6B64\u6307\u5357\u6BB5\u843D\u5C55\u5F00\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u6B21\u6307\u5357\u6B63\u6587\u672A\u63D0\u4F9B\u5177\u4F53\u5355\u4EF7\u3001\u514D\u8D39\u989D\u5EA6\u3001\u901F\u7387\u9650\u5236\u6216\u914D\u989D\uFF1B\u5BFC\u822A\u4E2D\u7684 Pricing \u94FE\u63A5\u4E0D\u6784\u6210\u5DF2\u8BFB\u53D6\u7684\u4EF7\u683C\u8BC1\u636E\u3002",
    "source_url": "https://developers.openai.com/api/docs/guides/text"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [
    "OpenAI Responses API \u751F\u6210\u6587\u672C",
    "\u89E3\u6790 Responses output \u4E0E output_text",
    "OpenAI model input instructions \u8BF7\u6C42\u793A\u4F8B"
  ],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-24T17:45:07.7921938\u002B00:00",
      "title": "Text generation | OpenAI API",
      "url": "https://developers.openai.com/api/docs/guides/text"
    }
  ],
  "summary": "OpenAI \u5B98\u65B9\u6587\u672C\u751F\u6210\u6307\u5357\u5C55\u793A Responses HTTP API\uFF0C\u4EE5\u6A21\u578B\u548C\u8F93\u5165\u751F\u6210\u6587\u672C\u6216\u7ED3\u6784\u5316\u5185\u5BB9\uFF1B\u9700 Bearer API key\uFF0C\u8F93\u51FA\u53EF\u80FD\u542B\u591A\u7C7B\u6761\u76EE\uFF0C\u672C\u6B21\u672A\u8C03\u7528\u3002",
  "tags": [
    "OpenAI",
    "Responses API",
    "text generation",
    "HTTP API",
    "LLM",
    "documentation"
  ],
  "terms_url": null,
  "title": "OpenAI Responses API \u2014 Text Generation",
  "unknowns": [
    "\u8D26\u6237\u5F00\u901A\u3001\u6709\u6548 API key \u6743\u9650\u548C\u53EF\u7528\u6A21\u578B\u672A\u77E5\u3002",
    "\u5F53\u524D\u7EDD\u5BF9\u5355\u4EF7\u3001\u514D\u8D39\u989D\u5EA6\u3001\u901F\u7387\u9650\u5236\u548C\u914D\u989D\u672A\u77E5\u3002",
    "\u6570\u636E\u4FDD\u7559\u3001\u8BAD\u7EC3\u7528\u9014\u53CA\u9A7B\u7559\u6761\u4EF6\u672A\u7531\u672C\u6B21\u6B63\u6587\u786E\u8BA4\u3002",
    "\u672A\u6267\u884C\u8BF7\u6C42\u3001\u751F\u6210\u5185\u5BB9\u3001\u8FD0\u884C SDK/CLI \u793A\u4F8B\u6216\u8C03\u7528\u5DE5\u5177\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:45:07.7921938\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developers.openai.com/api/docs/guides/text"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-f8536bb7406e17273f32dba4",
  "version": 2,
  "source_url": "https://developers.openai.com/api/docs/guides/text",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://developers.openai.com/api/docs/guides/text",
    "final_url": "https://developers.openai.com/api/docs/guides/text",
    "status_code": 200,
    "title": "Text generation | OpenAI API",
    "description": "Learn how to use the OpenAI API to generate text from a prompt. Learn about message types and available text formats like JSON and Structured Outputs.",
    "checked_at": "2026-10-24T17:45:07.7921938\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:45:11.1728156\u002B00:00",
  "updated_at": "2026-10-24T17:49:47.4498609\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-f8536bb7406e17273f32dba4?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-f8536bb7406e17273f32dba4?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u5927\u8BED\u8A00\u6A21\u578B\u6587\u672C\u751F\u6210 Responses API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-4ee757fe6f1f19e192e7339275dcc42f",
        "source_url": "https://developers.openai.com/api/docs/guides/text",
        "content_sha256": "b220ff38451acbd54c06e99a4a0bcd77aeaac9b2d4be16697a5e3a3cc9d4c380",
        "decoded_bytes": 502508,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:45:07.7921938\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "b220ff38451acbd54c06e99a4a0bcd77aeaac9b2d4be16697a5e3a3cc9d4c380",
        "text_utf8_bytes": 502508,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-f8536bb7406e17273f32dba4/materials/material-4ee757fe6f1f19e192e7339275dcc42f?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-c7d3d5de6e3648d1a951112c21262ba0",
    "reason": "\u4F9D\u636E\u672C\u6B21\u5B98\u65B9\u6587\u672C\u751F\u6210\u6307\u5357\u6574\u7406 Responses \u7AEF\u70B9\u3001Bearer API key\u3001model/input \u53CA\u8F93\u51FA\u89E3\u6790\u6761\u4EF6\uFF1B\u4E0D\u4ECE\u4EA7\u54C1\u5BFC\u822A\u5916\u63A8\u80FD\u529B\uFF0C\u4FDD\u7559\u8D26\u6237\u3001\u8D39\u7528\u53CA\u6570\u636E\u6761\u4EF6\u672A\u77E5\u3002",
    "source_urls": [
      "https://developers.openai.com/api/docs/guides/text"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-f8536bb7406e17273f32dba4",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-f8536bb7406e17273f32dba4?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-f8536bb7406e17273f32dba4?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure