对话生成 / 联网搜索 / 推理（Responses API · 推荐）

POST

/v1/responses

model 填 "gpt-5.5"。仅在此路径生效的关键能力：

🌐 联网搜索 tools=[{"type":"web_search"}]

📏 verbosity text.verbosity (low/medium/high)

📐 严格 JSON text.format.type=json_schema + strict=true

💬 系统指令 instructions

🧠 推理控制 reasoning.effort + reasoning.summary

max_output_tokens 对长输出不严格截断。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

{
    "model": "gpt-5.5",
    "input": "用一句话解释熵增定律。",
    "max_output_tokens": 500
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/responses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-5.5",
    "input": "用一句话解释熵增定律。",
    "max_output_tokens": 500
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "id": "resp_0bb166b0ad54c7c50169f436031cbc8196b157b0eeb60d8eed",
    "object": "response",
    "status": "completed",
    "created_at": 0,
    "completed_at": 0,
    "model": "string",
    "output": [
        {
            "type": "message",
            "role": "string",
            "content": [
                {
                    "type": "output_text",
                    "text": "string"
                }
            ],
            "name": "string",
            "arguments": "string"
        }
    ],
    "reasoning": {
        "effort": "string",
        "summary": "string"
    },
    "text": {
        "format": {},
        "verbosity": "string"
    },
    "tool_usage": {
        "web_search": {
            "num_requests": 0
        },
        "image_gen": {
            "input_tokens": 0,
            "output_tokens": 0,
            "total_tokens": 0
        }
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 0
    }
}

🟠401

🟠429

🔴500

修改于 2026-05-06 07:20:17

对话生成（chat/completions 兼容入口）