网络搜索工具

主站接口

https://api.huandutech.com/v1

POST

/responses

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-4.1",
    "tools": [
        {
            "type": "web_search_preview"
        }
    ],
    "input": "今天有什么积极正面的新闻?"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.huandutech.com/v1/responses' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-4.1",
    "tools": [
        {
            "type": "web_search_preview"
        }
    ],
    "input": "今天有什么积极正面的新闻?"
}'

返回响应

🟢200OK

application/json

Body

示例

{
    "id": "resp_67ccf18ef5fc8190b16dbee19bc54e5f087bb177ab789d5c",
    "object": "response",
    "created_at": 1741484430,
    "status": "completed",
    "error": null,
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "model": "gpt-4.1",
    "output": [
        {
            "type": "web_search_call",
            "id": "ws_67ccf18f64008190a39b619f4c8455ef087bb177ab789d5c",
            "status": "completed"
        },
        {
            "type": "message",
            "id": "msg_67ccf190ca3881909d433c50b1f6357e087bb177ab789d5c",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "截至今天，2025年3月9日，一则值得关注的积极新闻是中国科学家在可再生能源领域取得重大突破，成功研发出一种新型高效太阳能电池，转化率达到了创纪录的35%，这可能会极大推动清洁能源的普及和应用。这项技术预计将使太阳能发电成本降低约40%，为全球减少碳排放提供了新的解决方案。",
                    "annotations": [
                        {
                            "type": "url_citation",
                            "start_index": 42,
                            "end_index": 100,
                            "url": "https://example.com/renewable-energy-breakthrough/?utm_source=chatgpt.com",
                            "title": "中国科学家在可再生能源领域取得重大突破"
                        },
                        {
                            "type": "url_citation",
                            "start_index": 101,
                            "end_index": 150,
                            "url": "https://example.com/solar-cell-efficiency-record/?utm_source=chatgpt.com",
                            "title": "新型高效太阳能电池转化率创纪录"
                        },
                        {
                            "type": "url_citation",
                            "start_index": 151,
                            "end_index": 200,
                            "url": "https://example.com/clean-energy-cost-reduction/?utm_source=chatgpt.com",
                            "title": "太阳能发电成本有望降低40%"
                        }
                    ]
                }
            ]
        }
    ],
    "parallel_tool_calls": true,
    "previous_response_id": null,
    "reasoning": {
        "effort": null,
        "summary": null
    },
    "store": true,
    "temperature": 1,
    "text": {
        "format": {
            "type": "text"
        }
    },
    "tool_choice": "auto",
    "tools": [
        {
            "type": "web_search_preview",
            "domains": [],
            "search_context_size": "medium",
            "user_location": {
                "type": "approximate",
                "city": null,
                "country": "US",
                "region": null,
                "timezone": null
            }
        }
    ],
    "top_p": 1,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 328,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 356,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 684
    },
    "user": null,
    "metadata": {}
}

图像分析响应

文件搜索工具