Responses格式

POST

/v1/responses

OpenAI Responses API，用于创建模型响应。
支持多轮对话、工具调用、推理等功能。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "model": "string",
    "input": "string",
    "instructions": "string",
    "max_output_tokens": 0,
    "temperature": 0,
    "top_p": 0,
    "stream": true,
    "tools": [
        {}
    ],
    "tool_choice": "string",
    "reasoning": {
        "effort": "low",
        "summary": "string"
    },
    "previous_response_id": "string",
    "truncation": "auto"
}

请求示例代码

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": "string",
    "input": "string",
    "instructions": "string",
    "max_output_tokens": 0,
    "temperature": 0,
    "top_p": 0,
    "stream": true,
    "tools": [
        {}
    ],
    "tool_choice": "string",
    "reasoning": {
        "effort": "low",
        "summary": "string"
    },
    "previous_response_id": "string",
    "truncation": "auto"
}'

返回响应

🟢200成功

application/json

成功创建响应

Bodyapplication/json

示例

{
    "id": "string",
    "object": "response",
    "created_at": 0,
    "status": "completed",
    "model": "string",
    "output": [
        {
            "type": "string",
            "id": "string",
            "status": "string",
            "role": "string",
            "content": [
                {
                    "type": "string",
                    "text": "string"
                }
            ]
        }
    ],
    "usage": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 0,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "text_tokens": 0,
            "audio_tokens": 0,
            "image_tokens": 0
        },
        "completion_tokens_details": {
            "text_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 0
        }
    }
}

修改于 2026-08-07 06:13:46

ChatCompletions格式

Gemini文本聊天