Skip to main content
POST

授权

Authorization
string
header
必填

使用来自 https://omniall.ai/dashboard 的 Authorization: Bearer sk-...

请求体

application/json

OpenAI Responses API 请求体(POST /v1/responses)。新版 OpenAI 模型与内置工具推荐使用。

model
string
必填

模型广场中的模型 ID。

示例:

"gpt-5"

input

用户输入:纯字符串,或由 input_text / input_image / input_file 等组成的数组。

instructions
string

本次响应的系统级指令(类似 system prompt)。

max_output_tokens
integer

模型最多可生成的 token 数。

temperature
number

采样温度。

top_p
number

核采样参数。

stream
boolean

为 true 时通过 SSE 流式返回事件。

stream_options
object

流式输出

tools
object[]

内置工具(如 { "type": "web_search_preview" })和/或用于 Agent 的函数工具。

tool_choice

工具选择方式(auto、必选或指定工具)。

parallel_tool_calls

支持时允许一轮内多次工具调用。

max_tool_calls
integer

本次响应的工具调用上限。

previous_response_id
string

从先前 response id 继续(多轮无需重发完整历史)。

conversation
object

使用 Responses 会话状态时的 conversation 对象/id。

reasoning
object

推理模型的推理控制。

text
object

文本格式配置(支持时包含结构化输出 / json_schema)。

include
string[]

响应载荷中需要额外包含的字段。

truncation
enum<string>

上下文溢出处理:auto 或 disabled。

可用选项:
auto,
disabled
metadata
object

附加到响应的任意元数据。

store

上游是否可存储交互(视渠道设置而定)。

user
string

终端用户标识,用于滥用监控。

响应

Response 对象(流式时为 SSE 事件)。

Responses 接口

id
string

响应 id(配合 previous_response_id 使用)。

object
string

通常为 response。

示例:

"response"

created_at
integer

Unix 时间戳。

status
enum<string>

生命周期状态:completed、failed、in_progress、incomplete。

可用选项:
completed,
failed,
in_progress,
incomplete
model
string

所用模型。

output
object[]

输出项(消息、工具调用等)。从消息内容块读取回答文本。

usage
object

Token 用量。