跳转到主要内容
POST
OpenAI GPT 模型覆盖聊天、编程、推理和 Agent 工作流。本页 Playground 使用 Responses,所有 GPT 模型都支持该格式。

模型

  • gpt-6.1-sol — GPT-6.1 Sol。支持 Responses 和 Chat Completions。
  • gpt-6.1-terra — GPT-6.1 Terra,适用于视觉推理、计算机操作和自然写作的快速模型。支持 Responses 和 Chat Completions。
  • gpt-6-astra — GPT-6 Astra,适用于高级推理、编程和 Agent 工作流。支持 Responses 和 Chat Completions。
  • gpt-6-sol — GPT-6 Sol。支持 Responses 和 Chat Completions。
  • gpt-6-luna — GPT-6 Luna,GPT-6 的低成本档位。支持 Responses 和 Chat Completions。
  • gpt-5-6-sol — GPT-5.6 Sol,适用于前沿编程和 Agent 工作流。仅支持 Responses。
  • gpt-5-6-terra — GPT-5.6 Terra。仅支持 Responses。
  • gpt-5-6-luna — GPT-5.6 Luna,适用于高吞吐量自动化。仅支持 Responses。
  • gpt-5.5 — GPT-5.5。支持 Responses 和 Chat Completions。
  • gpt-5.4 — GPT-5.4。支持 Responses 和 Chat Completions。
  • gpt-5.2 — GPT-5.2。支持 Responses 和 Chat Completions。

示例

  • 基础文本响应 — 纯字符串 input 加 max_output_tokens。
  • 图像理解 — 包含 input_text 和 input_image 的结构化 input。
  • 网页搜索 — tools 中使用 web_search_preview。
  • 流式响应 — stream: true,以 SSE 返回。
如需以 Chat Completions 格式调用模型,把相同的 model id 发送到 Chat Completions。

注意事项

  • gpt-5-6-sol、gpt-5-6-terra 和 gpt-5-6-luna 只接受 /v1/responses。
  • 网页搜索等工具是否可用取决于所选模型。
  • 全部模型及其支持的格式见 LLM 模型。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
默认值:gpt-5.5
必填

OpenAI 模型 ID。gpt-5-6-sol、gpt-5-6-terra 和 gpt-5-6-luna 仅支持 Responses。

可用选项:
gpt-6.1-sol,
gpt-6.1-terra,
gpt-6-astra,
gpt-6-sol,
gpt-6-luna,
gpt-5-6-sol,
gpt-5-6-terra,
gpt-5-6-luna,
gpt-5.5,
gpt-5.4,
gpt-5.2
input
必填

纯文本输入或结构化输入项数组。

示例:

"Write a product tagline in one sentence."

instructions
string

引导模型响应的系统或开发者指令。

tools
object[]

模型可用的工具。工具支持情况取决于所选模型。

tool_choice

控制模型如何选择工具。

示例:

"auto"

max_output_tokens
integer

生成的最大输出 token 数。

必填范围: x >= 1
示例:

200

max_tokens
integer

用于兼容旧版的最大输出 token 字段。

必填范围: x >= 1
示例:

200

stream
boolean
默认值:false

是否以 SSE 格式流式输出。

示例:

false

store
boolean

支持时,是否存储该响应。

示例:

false

reasoning
object

推理配置,所选模型支持时可用。

示例:
text
object

文本输出配置,例如支持时的结构化输出格式选项。

metadata
object

请求的自定义元数据键值对。

previous_response_id
string

用于继续对话的上一个响应 ID。

include
string[]

支持时,需要额外包含的响应字段。

parallel_tool_calls
boolean

是否允许模型并行调用多个工具。

truncation
string

长上下文的截断行为,支持时可用。

示例:

"auto"

user
string

最终用户标识符,用于滥用监控和请求追踪。

background
boolean

支持时,是否以后台模式运行响应。

service_tier
string

服务层级选择,支持时可用。

示例:

"auto"

prompt
object

提示词对象,所选模型支持时可用。

temperature
number

控制输出的随机性,范围 0-2。

必填范围: 0 <= x <= 2
示例:

1

top_p
number

核采样参数,范围 0-1。

必填范围: 0 <= x <= 1
示例:

1

响应

响应已创建

响应对象。

id
string
示例:

"resp_9876543210"

object
string
示例:

"response"

created_at
integer
示例:

1677652288

status
string
示例:

"completed"

model
string
示例:

"gpt-5.5"

output
object[]
usage
object

token 用量统计。