创建函数调用

POST

/v1/responses

https://platform.openai.com/docs/api-reference/responses/create
部分OpenAI模型仅支持Response格式，例如o3-pro，codex-mini-latest

请求参数

Header 参数

Body 参数application/json

示例

	
{
    "input": [
        {
            "role": "user",
            "content": "请同时帮我做以下几件事：\n1. 获取当前系统时间\n2. 查看系统信息（操作系统、内存等）\n3. 帮我计算 123.5 + 456.7 的结果\n4. 生成3个1-100之间的随机数\n\n这是一个并行工具调用测试，请同时执行这些任务。"
        }
    ],
    "metadata": {
        "model_id": "32"
    },
    "model": "gpt-4.1",
   
    "tool_choice": "auto",
    "tools": [
        {
            "type": "function",
            "name": "random_generator",
            "description": "生成指定范围内的随机数，支持批量生成",
            "parameters": {
                "type": "object",
                "properties": {
                    "min": {
                        "description": "最小值（默认1）",
                        "type": "integer"
                    },
                    "max": {
                        "description": "最大值（默认100）",
                        "type": "integer"
                    },
                    "count": {
                        "description": "生成数量（默认1，最大10）",
                        "type": "integer"
                    }
                }
            }
        },
        {
            "type": "function",
            "name": "system_info",
            "description": "获取当前系统的基本信息，包括操作系统、Java版本、内存使用情况等",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "type": "function",
            "name": "math_calculator",
            "description": "执行基本数学运算，支持加减乘除和幂运算",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "description": "第一个数字",
                        "type": "number"
                    },
                    "b": {
                        "description": "第二个数字",
                        "type": "number"
                    },
                    "operation": {
                        "description": "运算类型: add, subtract, multiply, divide, power",
                        "type": "string"
                    }
                },
                "required": [
                    "operation",
                    "a",
                    "b"
                ]
            }
        },
        {
            "type": "function",
            "name": "current_time",
            "description": "获取当前系统时间",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/responses' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": [
        {
            "role": "user",
            "content": "请同时帮我做以下几件事：\n1. 获取当前系统时间\n2. 查看系统信息（操作系统、内存等）\n3. 帮我计算 123.5 + 456.7 的结果\n4. 生成3个1-100之间的随机数\n\n这是一个并行工具调用测试，请同时执行这些任务。"
        }
    ],
    "metadata": {
        "model_id": "32"
    },
    "model": "gpt-4.1",
   
    "tool_choice": "auto",
    "tools": [
        {
            "type": "function",
            "name": "random_generator",
            "description": "生成指定范围内的随机数，支持批量生成",
            "parameters": {
                "type": "object",
                "properties": {
                    "min": {
                        "description": "最小值（默认1）",
                        "type": "integer"
                    },
                    "max": {
                        "description": "最大值（默认100）",
                        "type": "integer"
                    },
                    "count": {
                        "description": "生成数量（默认1，最大10）",
                        "type": "integer"
                    }
                }
            }
        },
        {
            "type": "function",
            "name": "system_info",
            "description": "获取当前系统的基本信息，包括操作系统、Java版本、内存使用情况等",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "type": "function",
            "name": "math_calculator",
            "description": "执行基本数学运算，支持加减乘除和幂运算",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "description": "第一个数字",
                        "type": "number"
                    },
                    "b": {
                        "description": "第二个数字",
                        "type": "number"
                    },
                    "operation": {
                        "description": "运算类型: add, subtract, multiply, divide, power",
                        "type": "string"
                    }
                },
                "required": [
                    "operation",
                    "a",
                    "b"
                ]
            }
        },
        {
            "type": "function",
            "name": "current_time",
            "description": "获取当前系统时间",
            "parameters": {
                "type": "object",
                "properties": {}
            }
        }
    ]
}'

返回响应

🟢200OK

application/json

Body

示例

{
  "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.0,
  "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.0,
  "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": {}
}

修改于 2026-03-24 09:54:18

创建模型响应

创建模型响应(流式返回)