OpenAI Responses API 接入与 SDK

NAAPI 提供的 OpenAI Responses 兼容接口，适合新式推理模型、多轮响应链、工具调用和多模态输入。

LLM 必读

API Base URL：https://naapi.cc/v1

完整接口：POST https://naapi.cc/v1/responses

鉴权：Authorization: Bearer <API_KEY>

简单输入：input 可以直接使用字符串

原始输出：output[]，文本通常位于 output[].content[].text

OpenAI SDK 优先读取 response.output_text

API Key 建议从 NAAPI_API_KEY 环境变量读取

naapi.apifox.cn 只承载文档，请求必须发送到 https://naapi.cc/v1/responses。

适用场景

新项目使用 OpenAI 新式 SDK

需要分离 instructions 和 input

需要通过 previous_response_id 串联多轮对话

需要推理强度、工具调用、多模态或统一事件流

最小 curl 请求

将 MODEL 替换为账户当前可用的 Responses 兼容模型 ID。

核心字段

字段	必填	说明
`model`	是	模型 ID
`input`	建议	字符串或结构化消息数组
`instructions`	否	系统级指令
`max_output_tokens`	否	最大输出 Token 数
`stream`	否	`true` 启用 SSE 事件流
`tools`	否	Responses 工具定义
`tool_choice`	否	控制工具选择
`reasoning.effort`	否	`low` / `medium` / `high`
`previous_response_id`	否	引用真实的上一轮 Response ID
`truncation`	否	`auto` 或 `disabled`

Python 官方 SDK

继续上一轮对话

Python 流式输出

JavaScript 官方 SDK

文本提取

OpenAI 官方 SDK 优先使用 response.output_text。直接解析 HTTP JSON 时，不要假定 output[0] 永远是最终文本；output 还可能包含推理、工具调用等项目，应按 type 遍历提取 output_text。

LLM / Agent 执行规则

系统级要求写入 instructions，用户内容写入 input。

不要把 Chat Completions 的输出路径 choices[0].message.content 用在 Responses。

previous_response_id 必须来自真实的上一轮响应。

不要假定所有模型都接受 temperature、reasoning 或所有工具类型。

工具结果必须回传响应中的真实 call ID。

API Key 只从环境变量或密钥管理服务读取。

流式事件必须按 event.type 解析，不要把所有 SSE data 当成普通文本。

400 / 401 / 429 先读取 error.message，不要用原参数无限重试。

常见错误

状态	常见原因	处理
`400`	输入结构错误或模型不支持参数	读取 `error.message`，移除不兼容字段
`401`	API Key 缺失或失效	检查 Bearer 鉴权
`429`	频率、并发或额度限制	降低并发并使用退避
`5xx`	网关或上游短暂异常	有上限地重试，避免重放工具副作用

OpenAI Responses

OpenAI Responses API 接入与 SDK#

LLM 必读#

适用场景#

最小 curl 请求#

核心字段#

Python 官方 SDK#

继续上一轮对话#

Python 流式输出#

JavaScript 官方 SDK#

文本提取#

LLM / Agent 执行规则#

常见错误#