创建模型响应（Responses）

POST

/v1/responses

创建模型响应。兼容 OpenAI Responses API 的核心请求格式：通过 model 和 input 生成文本或结构化 JSON；可传入图片、文件；可配置工具调用、流式输出、会话状态、推理强度、采样参数和元数据。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

{
    "model": "gpt-5.4",
    "input": "Tell me a three sentence bedtime story about a unicorn."
}

请求示例代码

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.4",
    "input": "Tell me a three sentence bedtime story about a unicorn."
}'

返回响应

🟢200

application/json

创建成功。非流式请求返回 Response 对象；当 stream=true 时返回 SSE 事件流。

Body

示例

{
    "id": "resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b",
    "object": "response",
    "created_at": 1741476542,
    "status": "completed",
    "completed_at": 1741476543,
    "error": null,
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "model": "gpt-5.4",
    "output": [
        {
            "type": "message",
            "id": "msg_67ccd2bf17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "Hi there! How can I assist you today?",
                    "annotations": []
                }
            ]
        }
    ],
    "parallel_tool_calls": true,
    "previous_response_id": null,
    "reasoning": {
        "effort": null,
        "summary": null
    },
    "store": true,
    "temperature": 1,
    "text": {
        "format": {
            "type": "text"
        }
    },
    "tool_choice": "auto",
    "tools": [],
    "top_p": 1,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 37,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 11,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 48
    },
    "user": null,
    "metadata": {}
}

🟠400

🟠401

🟠429

🔴500

修改于 2026-05-26 07:53:55

创建模型响应（Chat）

图像（Images）