文本对话（官方推荐/新一代）

请求参数

Body 参数application/json必填

示例

{
    "model": "gpt-5.4",
    "input": [
        {
            "role": "user",
            "content": "Hello"
        }
    ],
    "max_output_tokens": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/v1/responses' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-5.4",
    "input": [
        {
            "role": "user",
            "content": "Hello"
        }
    ],
    "max_output_tokens": 1
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "id": "resp_0ce9a406ecbd11a10169806805585081918753b35deed98bbf",
    "object": "response",
    "created_at": 1770022917,
    "status": "completed",
    "background": false,
    "completed_at": 1770022918,
    "error": null,
    "frequency_penalty": 0,
    "incomplete_details": null,
    "instructions": "",
    "max_output_tokens": null,
    "max_tool_calls": null,
    "model": "gpt-5.1-codex",
    "output": [
        {
            "id": "rs_0ce9a406ecbd11a10169806805cf108191af74cb703a646257",
            "type": "reasoning",
            "encrypted_content": "gAAAAABpgGgGD5krS6Ab0r_eGSzM9qCzZsZMJOo_75N9tCLvXJ64TDVfPvMaeQlHLdUh8X-wHctNNwOajrgsl-SM5x7swAhwUb7TT-Os2bl96qcsXk2qvxe6LWeoCT509Z5MafndPtE7T5M_IkIVgc9EKxcBKso4kh8OgYbwfLRehPMW9Su-JJOBRCyAIlze2L-0EGNF48wIDSqovrdaym9-CzAeIZca7SzIxqC6tUuucP-1Ly_3F2RCXOYM0g6nlAtRLZPTlRRHAHE_bkKcUS5nOokCIpeBt7z1Bh_fpcILtXaCVWjPsJZLVm3bY04NH6CT3vrgGMW6dpifb7rX_293vHM9idArwxbFNzBuk-h54iC0oitIcFcw5r6QyiwEjleY6aHvGjkwizUl1OG6dA-A3i-_bGUHvjeIOOVOk2zvHT5XhtopgGnNQp1tBtkNEewkiIa5q11NTcWbDWKfEDsgjAuIZfQi51FBCbDD6U7oRoaP6lKx4kZtzFNFH8p4DQjbkgKAKXuaE2U14BNu07BG2mo9B7q_aqZTy94SPo7ihNzcLRizu_LQsgCfVZZQJ4Sk046iQubgoPZEx_9lcDbuBgMyj_tLmV9H5jhP9yuTIZNEKBZ2CLITHjgoeXGOSpeKGvXS7Blrn3JjMd2_IZngNA9Duok-Z9Rlua1Rv3hZZ1YntDX3ZtaYSreyeQPB2nk1mo1XLVGNledK_BZryCdt4lVQ2kRUAzKGwEw0bjxGG-mDo0ytZHarA7dmwLawBs92poG8mXWVK2HDauTvnBgKkgJhJ1-fam8pwhFn9BCTtAiXkZUFlSJOJVypOGtopZcySgVWlsHL4tDdznposd2wZ1Av-4pGfA==",
            "summary": []
        },
        {
            "id": "msg_0ce9a406ecbd11a10169806806d1588191bf694c0d8b780880",
            "type": "message",
            "status": "completed",
            "content": [
                {
                    "type": "output_text",
                    "annotations": [],
                    "logprobs": [],
                    "text": "Hi there! How can I help you today?"
                }
            ],
            "role": "assistant"
        }
    ],
    "parallel_tool_calls": true,
    "presence_penalty": 0,
    "previous_response_id": null,
    "prompt_cache_key": "93d73de6-a762-40d0-b813-3b34b636c3f1",
    "prompt_cache_retention": null,
    "reasoning": {
        "effort": "medium",
        "summary": null
    },
    "safety_identifier": "user-CGHy2XkmymDmgpMgWoGmIn6M",
    "service_tier": "default",
    "store": false,
    "temperature": 1,
    "text": {
        "format": {
            "type": "text"
        },
        "verbosity": "medium"
    },
    "tool_choice": "auto",
    "tools": [],
    "top_logprobs": 0,
    "top_p": 1,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 7,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 23,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 30
    },
    "user": null,
    "metadata": {}
}