联网搜索

联网搜索是通过进行搜索引擎搜索以解决数据时效性、模型知识盲区等问题的工具，使用联网搜索功能仅需在调用请求中指定tools.type为web_search可激活联网搜索工具的使用。指定后，模型会根据用户请求进行意图识别并返回是否需要进行联网搜索。

联网搜索按次进行计费，对于搜索来源信息源不做分别计费。您可在返回体的usage.web_search_queries字段中确认此次请求一共进行的联网搜索次数。此外，使用联网搜索可能会产生额外tokens消耗费用，联网搜索涉及到意图识别、问题改写、总结，usage字段中将展示真实的输入输出tokens消耗量。

请求示例

curl -X POST https://kspmas.ksyun.com/v1/chat/completions \
-H "Authorization: Bearer $KSC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "deepseek-v3.2",
    "messages": [
        {"role": "user", "content": "以JSON形式输出今天是星期几以及日期、月份、年份，进行联网搜索确定今天的日期"}
    ],
    "response_format":{
        "type": "json_object"
    },
    "tools": [
       {"type": "web_search"}
    ]
}'

响应体

{
    "id": "as-x9veq1z210",
    "object": "chat.completion",
    "created": 1770622724,
    "model": "deepseek-v3.2",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "{\n  \"weekday\": \"星期一\",\n  \"date\": 9,\n  \"month\": 2,\n  \"year\": 2026\n}"
            },
            "finish_reason": "stop",
            "flag": 0
        }
    ],
    "usage": {
        "prompt_tokens": 7017,
        "completion_tokens": 33,
        "total_tokens": 7050,
        "web_search_queries": 1
    }
}

启用联网搜索时，系统提示词及用户提示词对搜索请求会有较大影响，您可在系统提示词或用户提示词中对模型的联网搜索规则做出规定，以优化联网搜索的准确性与效率。