Create function call Copy

POST

/v1/responses

https://platform.openai.com/docs/api-reference/responses/create Some OpenAI models only support the Response format, such as o3-pro and codex-mini-latest.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/responses' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": [
        {
            "role": "user",
            "content": "Please help me do the following things simultaneously:\n1. Get the current system time\n2. Check system information (operating system, memory, etc.)\n3. Calculate the result of 123.5 + 456.7\n4. Generate 3 random numbers between 1 and 100\n\nThis is a parallel tool invocation test, please execute these tasks simultaneously."
        }
    ],
    "metadata": {
        "model_id": "32"
    },
    "model": "gpt-4.1",
    "tool_choice": "auto",
    "tools": [
        {
            "type": "function",
            "name": "random_generator",
            "description": "Generate random numbers within a specified range, supporting batch generation",
            "parameters": {
                "type": "object",
                "properties": {
                    "min": {
                        "description": "Minimum value (default 1)",
                        "type": "integer"
                    },
                    "max": {
                        "description": "Maximum value (default 100)",
                        "type": "integer"
                    },
                    "count": {
                        "description": "Number to generate (default 1, maximum 10)",
                        "type": "integer"
                    }
                }
            }
        },
        {
            "type": "function",
            "name": "system_info",
            "description": "Retrieve basic information about the current system, including operating system, Java version, memory usage, etc.",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "type": "function",
            "name": "math_calculator",
            "description": "Performs basic mathematical operations, supporting addition, subtraction, multiplication, division, and exponentiation.",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "description": "The first number",
                        "type": "number"
                    },
                    "b": {
                        "description": "The second number",
                        "type": "number"
                    },
                    "operation": {
                        "description": "Operation type: add, subtract, multiply, divide, power",
                        "type": "string"
                    }
                },
                "required": [
                    "operation",
                    "a",
                    "b"
                ]
            }
        },
        {
            "type": "function",
            "name": "current_time",
            "description": "Get the current system time",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        }
    ]
}'

Response Example

{
    "id": "resp_68ac1558e9488190bcc2cbb94c7d7a140b8064b15a091a77",
    "object": "response",
    "created_at": 1756108120,
    "status": "completed",
    "background": false,
    "content_filters": null,
    "error": null,
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "max_tool_calls": null,
    "model": "gpt-4.1-data",
    "output": [
        {
            "id": "fc_68ac15594be88190a58217f75a6a54cc0b8064b15a091a77",
            "type": "function_call",
            "status": "completed",
            "arguments": "{\"sign\":\"Aquarius\"}",
            "call_id": "call_6kbB2GTk62PPUNdGuBJPx9KQ",
            "name": "get_horoscope"
        }
    ],
    "parallel_tool_calls": true,
    "previous_response_id": null,
    "prompt_cache_key": null,
    "reasoning": {
        "effort": null,
        "summary": null
    },
    "safety_identifier": null,
    "service_tier": "default",
    "store": true,
    "temperature": 1,
    "text": {
        "format": {
            "type": "text"
        }
    },
    "tool_choice": "auto",
    "tools": [
        {
            "type": "function",
            "description": "Get today's horoscope for an astrological sign.",
            "name": "get_horoscope",
            "parameters": {
                "properties": {
                    "sign": {
                        "description": "An astrological sign like Taurus or Aquarius",
                        "type": "string"
                    }
                },
                "required": [
                    "sign"
                ],
                "type": "object"
            },
            "strict": true
        }
    ],
    "top_p": 1,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 62,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 18,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 80
    },
    "user": null,
    "metadata": {}
}

Modified at 2026-02-08 06:57:56

Creation complete

GPTs Dialogue