联网搜索

联网搜索是一款基础联网搜索工具，能为您的大模型获取实时的公开网络信息（如新闻、商品、天气等）。

核心能力

联网搜索方式灵活：支持强制搜索和意图识别两种方式，开通意图识别后，将自主判断是否进行联网搜索，无需手动触发。
提前返回搜索来源：流式响应中，首包会返回所有搜索来源。
多工具混合调用：可与自定义 Function、工具协同使用，模型会自动判断调用优先级与必要性。
响应模式灵活：支持流式和非流式两种响应，两种方式都将返回搜索、总结内容。

快速开始

使用前需要开通联网服务插件。

开通服务

访问控制台-插件管理，选择开通联网服务插件。
联网服务插件收费参考定价策略，注意，是否触发搜索调用由模型判断，一轮搜索调用（若模型判定需要）可能会发起多个关键词同时搜索，会多次使用联网内容插件，您可以通过 max_keyword 参数来限制一轮搜索最大的关键词数量，进一步控制调用频次与成本。

说明：获取 API Key 等准备工作，请参考首次调用API。

示例代码

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("MIMO_API_KEY"),
    base_url="https://api.xiaomimimo.com/v1"
)

completion = client.chat.completions.create(
    model="mimo-v2.6-pro",
    messages=[
        {
            "role": "system",
            "content": "You are MiMo, an AI assistant developed by Xiaomi. Today is date: Tuesday, December 16, 2025. Your knowledge cutoff date is December 2024."
        },
        {
            "role": "user",
            "content": "武汉明天天气怎么样？"
        }
    ],
    max_completion_tokens=1024,
    temperature=1.0,
    top_p=0.95,
    stream=False,
    stop=None,
    frequency_penalty=0,
    presence_penalty=0,
    extra_body={
        "thinking": {"type": "disabled"}
    },
    tools=[
        {
            "type": "web_search",
            "max_keyword": 3,
            "force_search": True,
            "limit": 1,
            "user_location": {
                "type": "approximate",
                "country": "China",
                "region": "Hubei",
                "city": "Wuhan"
            }
        }
    ],
    tool_choice="auto"
)

print(completion.model_dump_json())

响应示例

{
    "id": "9ffcbd3a-d3a2-4788-9edd-d8a79e47ae15_33e773cc83af482aa0b41b9fd120fdf1",
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "message": {
                "content": "武汉明天（9月23日）将以阴天为主，局部有阵雨，气温在22~25℃之间。受冷空气影响，近期气温有所回落，体感偏凉，出门建议携带雨具并适当添衣。",
                "role": "assistant",
                "annotations": [
                    {
                        "type": "url_citation",
                        "url": "https://www.weather.com.cn/weather/101200101.shtml",
                        "title": "武汉天气预报,武汉7天天气预报,武汉15天天气预报,武汉天气查询",
                        "summary": " 武汉天气预报，及时准确发布中央气象台天气信息，便捷查询武汉今日天气，武汉周末天气，武汉一周天气预报，武汉 …",
                        "site_name": "中国天气网",
                        "publish_time": "2026-09-21T08:32:25.0000000",
                        "logo_url": "https://weather.com.cn/favicon.ico"
                    },
                    {
                        "type": "url_citation",
                        "url": "https://www.qweather.com/weather/wuhan-101200101.html",
                        "title": "武汉市天气 空气质量 降水 预警以及武汉市历史天气 | 和风天气",
                        "summary": "2级 东北风56%相对湿度弱紫外线24°体感温度25km能见度0.0mm降水量1015hPa大气压24小时预报   5am    7am    8am    9am    11am    1pm    2pm    3pm    5pm    7pm    8pm    9pm    11pm    1am    2am    3am 温度 查看完整天气地图  未来预报今天09月15日 29°  22° 周三09月16日 26°  18° 周四09月17日 22°  18° 周五09月18日 24°  21° 周六09月19日 28°  23° 周日09月20日 31°  24° 周一09月21日 32°  22°   30天预报  空气质量优 34 PM2.5 39 PM10 92 O3 0.7 CO 11 SO2 17 NO2  预报和更多  太阳现在04:45现在04:45高度角-18°方位75°ENE月亮 蛾眉月 现在04:45现在04:45高度角-64°方位68°ENE生活指数舒适度指数较舒适洗车指数较适宜穿衣指数热感冒指数少发运动指数较不宜旅游指数适宜紫外线指数弱空气污染扩散指数良武汉市的历史天气  更多历史天气  武汉市气象概述武汉属亚热带季风气候区武汉稳定≥10℃活动积温在5000℃～5300℃之间,年无霜期240天。温度 查看完整天气地图  卫星云图天气排行  今日最高温    空气质量...",
                        "site_name": "和风天气",
                        "publish_time": "2026-09-15T00:00:00.0000000",
                        "logo_url": "https://www.qweather.com/favicon.ico"
                    },
                    {
                        "type": "url_citation",
                        "url": "https://www.sina.cn/news/article/comos_nishzsi2828295.html",
                        "title": "武汉未来一周天气预报:晴好升温至33℃,下周初阵雨来袭+FAQ|武汉天气|一周天气预报|武汉未来7天|武汉温度|武汉降雨_新浪新闻",
                        "summary": "和风天气30天预报指出,未来一周最高温出现在9月25日(33℃),最低温出现在9月... 🌡️ 最高33℃❄️ 最低21℃☀️ 晴好为主🌧️ 阵雨2天🍃 风力1-2级  | 日期 | 天气 | 气温(℃) | 风力 | 空气质量 |  |-----|-----|-----|-----|-----|  | 9月19日(周六) | 晴转多云 | 21~27 | 东北风2级 | 优 |   | 9月20日(周日) | 多云 | 22~30 | 北风1级 | 良 |   | 9月21日(周一) | 阴转阵雨 | 22~29 | 东北风2级 | 优 |   | 9月22日(周二) | 阴 | 22~25 | 东北风2级 | 优 |   | 9月23日(周三) | 多云 | 21~27 | 东北风1级 | 优 |   | 9月24日(周四) | 阴转多云 | 23~30 | 东北风1级 | 良 |   | 9月25日(周五) | 多云转中雨 | 24~33 | 北风1级 | 优| 　　数据来源:综合天气网、和风天气、全国天气网、2345天气预报(2026年9月19日发布) 02降雨分布:仅21日、25日有阵雨 ⏰ 出行提醒  9月21日(周一)阵雨伴雷电,建议错峰出行或备雨具  9月25日(周...",
                        "site_name": "新浪新闻",
                        "publish_time": "2026-09-19T06:13:50.0000000",
                        "logo_url": "https://sina.cn/favicon.ico"
                    }
                ],
                "tool_calls": null
            }
        }
    ],
    "created": 1790008349,
    "model": "mimo-v2.6-pro",
    "object": "chat.completion",
    "usage": {
        "completion_tokens": 60,
        "prompt_tokens": 1476,
        "total_tokens": 1536,
        "completion_tokens_details": {
            "reasoning_tokens": 0
        },
        "prompt_tokens_details": {
            "cached_tokens": 0
        },
        "web_search_usage": {
            "tool_usage": 3,
            "page_usage": 3
        }
    }
}

详细参数及调用说明参见 OpenAI Chat Completions API。暂不支持其他 API 协议。

支持的模型列表

当前支持 mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed 模型。

计费说明

联网服务插件的计费由以下两部分组成：

联网资源的使用次数：联网服务插件一次接口返回中，联网资源出现的次数
- 联网搜索工具每 1000 次调用费用：国内 ¥16 / 1000 次；海外 $5 / 1000 次。

通过 API 调用联网搜索时，一轮搜索调用会根据 max_keyword 数值发起对应数值的关键词同时搜索，会多次使用本插件。

模型 Token 消耗费用：联网搜索的网页内容会拼接到提示词中，增加模型的输入 Token，按照模型的标准价格计费。价格详情请参考定价与限速。

常见问题

开启联网搜索后，模型为何没有执行网络搜索？

可能有以下三种原因：

缓存：开启/关闭联网后，会有 5 分钟的缓存时间，5 分钟内联网搜索开关还未真实开启/关闭。
模型判断无需联网：模型判断当前问题不涉及实时信息，可直接使用自身知识回答。如需强制联网，请设置 force_search: true。
模型不支持：当前 mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed 支持联网搜索。

更新时间 2026 年 10 月 20 日