Responses Request (openai)

POST

/v1/responses

📘 API Introduction (OpenAI Native)

Responses API is a next-generation conversational interface introduced by OpenAI, specifically designed for reasoning models (GPT-5 series) and advanced capabilities.

Compared to the traditional Chat Completions API, the Responses API offers:

Finer reasoning control

Built-in tool calling capabilities (Tools)

Support for multimodal inputs (Text / Images / Files)

🎯 Applicable Scenarios

🧠 Reasoning-Intensive Tasks

Suitable for scenarios requiring complex reasoning (such as the GPT-5 series models).

🌐 Requires Web Search

Features a built-in Web Search Preview tool to support real-time information retrieval.

🛠️ Advanced Tool Calling

Supports the following capabilities:

Function Call

Custom Tool Call

🔄 Multi-turn Conversation Continuation

Maintains context using previous_response_id to achieve conversation continuity.

🔐 Authentication

All requests must be authenticated via a Bearer Token.

Header Example

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

{
    "model": "GPT-5.2-Chat",
    "input": [
        {
            "role": "system",
            "content": "You are a rigorous assistant."
        },
        {
            "role": "user",
            "content": "Translate: Hello World"
        }
    ],
    "maxOutputTokens": 120
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.peakkai.ai/v1/responses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "GPT-5.2-Chat",
    "input": [
        {
            "role": "system",
            "content": "You are a rigorous assistant."
        },
        {
            "role": "user",
            "content": "Translate: Hello World"
        }
    ],
    "maxOutputTokens": 120
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

1Text Response Example (Simple Conversation, Image, File)[Streaming] Text Response Example (Simple Conversation, Image, File)Web SearchReasoning ControlCustom Function Calling

{
    "error": {
        "message": "string",
        "type": "string",
        "param": "string",
        "code": "string"
    }
}

🟠400

🔴500

修改于 2026-11-02 09:46:28

Native Claude Format

Native OpenAI Format TTS

Responses Request (openai)

📘 API Introduction (OpenAI Native)#

🎯 Applicable Scenarios#

🧠 Reasoning-Intensive Tasks#

🌐 Requires Web Search#

🛠️ Advanced Tool Calling#

🔄 Multi-turn Conversation Continuation#

🔐 Authentication#

Header Example#