Chat(工具tools调用)

POST

/v1/chat/completions

最后修改时间：2026-09-02 07:44:43

官方指南
官方API文档
所有对话模型，都可使用此接口，修改 model 属性为模型名
给定一个提示，该模型将返回一个或多个预测的完成，并且还可以返回每个位置的替代标记的概率。
为提供的提示和参数创建完成
测试页面： https://cooksleep.github.io/newapi-special-test/

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-4o-mini",
    "messages": [
        {"role": "system", "content": "你是专业的天气助手，可以查询实时天气。"},
        {"role": "user", "content": "今天深圳天气怎么样？"}
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_current_weather",
                "description": "获取指定城市的当前天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {
                            "type": "string",
                            "description": "城市名称，例如：深圳、北京"
                        },
                        "unit": {
                            "type": "string",
                            "enum": ["celsius", "fahrenheit"],
                            "description": "温度单位，默认摄氏"
                        }
                    },
                    "required": ["city"]
                }
            }
        }
    ],
    "tool_choice": "auto",
    "temperature": 0.7
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-4o-mini",
    "messages": [
        {"role": "system", "content": "你是专业的天气助手，可以查询实时天气。"},
        {"role": "user", "content": "今天深圳天气怎么样？"}
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_current_weather",
                "description": "获取指定城市的当前天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {
                            "type": "string",
                            "description": "城市名称，例如：深圳、北京"
                        },
                        "unit": {
                            "type": "string",
                            "enum": ["celsius", "fahrenheit"],
                            "description": "温度单位，默认摄氏"
                        }
                    },
                    "required": ["city"]
                }
            }
        }
    ],
    "tool_choice": "auto",
    "temperature": 0.7
}'

返回响应

🟢200OK

application/json

Bodyapplication/json

示例

{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\n\nHello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}

修改于 2026-09-02 07:44:43

Chat(指定GPTs)

Chat(Claude Thinking)