Desearch

Authentication

对外开放的接口

POST 创建一个会话的任务

POST /api/conversation/anew

Body 请求参数

{
  "sessionId": "",
  "content": "帮我分析一下小米汽车的前景",
  "thinking": "deep",
  "workflow": "",
  "moreSettings": {}
}

请求参数

名称	位置	类型	必选	中文名	说明
x-api-key	header	string	是		none
body	body	object	否		none
» sessionId	body	string	是	会话ID	新发起会话传空字符串；多轮会话传会话ID；
» content	body	string	是	会话问题	none
» thinking	body	string	是	思考模式	deep：深度模式；major：专家模式；smart：普通模式
» workflow	body	string	是	执行模式	深度、专家、普通模式下传空字符串；其他模式下需要根据配置传参
» moreSettings	body	object	是	更多配置	none

返回示例

200 Response

{
  "code": 200,
  "v": "0.0.913",
  "msg": "成功",
  "data": {
    "thinking": "deep",
    "workflow": "",
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "questionId": 37540,
    "content": "帮我分析一下小米汽车的前景",
    "short": "WId4PKPa"
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	返回码	none
» v	string	true	none	版本号	none
» msg	string	true	none	提示文字	none
» data	object	true	none	数据内容	none
»» thinking	string	true	none	思考模式	none
»» workflow	string	true	none	执行模式	none
»» sessionId	string	true	none	会话ID	none
»» questionId	integer	true	none	问题ID	none
»» content	string	true	none	问题内容	none
»» short	string	true	none	短字符	none

GET 查询我的会话列表

GET /api/conversation/list

请求参数

名称	位置	类型	必选	说明
pageSize	query	integer	是	每页数量
pageNo	query	integer	是	页数
keyword	query	string	否	问题关键词搜索
startTime	query	string	否	会话创建时间搜索范围
endTime	query	string	否	会话创建时间搜索范围
thinking	query	string	否	思考模式
workflow	query	string	否	执行模式
x-api-key	header	string	否	none

返回示例

200 Response

{
  "code": 200,
  "v": "0.0.913",
  "msg": "成功",
  "data": {
    "count": 1,
    "pageNo": 1,
    "pageSize": 10,
    "lists": [
      {
        "sessionId": "3121642f186242479b575d72fec3b5d0",
        "title": "帮我分析一下小米汽车的前景",
        "createTime": "2025-07-02 09:15:08",
        "thinking": "deep",
        "workflow": "",
        "short": "WId4PKPa",
        "thinkingWorkflowName": "深度模式",
        "useKnowledge": 0,
        "onlyKnowledge": 0,
        "searchRange": "web"
      }
    ]
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	操作码	none
» v	string	true	none	版本号	none
» msg	string	true	none	提示文字	none
» data	object	true	none	数据内容	none
»» count	integer	true	none	总数量	none
»» pageNo	integer	true	none	当前页数	none
»» pageSize	integer	true	none	每页数量	none
»» lists	[object]	true	none	列表内容	none
»»» sessionId	string	false	none	会话ID	none
»»» title	string	false	none	会话标题	none
»»» createTime	string	false	none	创建时间	none
»»» thinking	string	false	none	思考模式	none
»»» workflow	string	false	none	执行模式	none
»»» short	string	false	none	短码	none
»»» thinkingWorkflowName	string	false	none	模式中文名	none
»»» useKnowledge	integer	false	none	是否用到知识库	none
»»» onlyKnowledge	integer	false	none	是否只用知识库查询	none
»»» searchRange	string	false	none	搜索范围	none

GET 查询会话当前状态

GET /api/conversation/status

1: '正在进行中',
2: '正常结束',
3: '用户主动结束',
4: '失败结束',
5: '排队等待中'

Body 请求参数

{}

请求参数

名称	位置	类型	必选	说明
sessionId	query	string	是	会话ID
x-api-key	header	string	是	none
body	body	object	否	none

返回示例

200 Response

{
  "code": 200,
  "v": "0.0.913",
  "msg": "成功",
  "data": {
    "status": 1,
    "thinking": "deep",
    "workflow": "",
    "message": "会话生成中",
    "content": "帮我分析一下小米汽车的前景",
    "time": "",
    "thinkingWorkflowName": "深度模式",
    "pptUrl": "",
    "wavUrl": "",
    "htmlUrl": "",
    "wavScriptUrl": "",
    "isShare": 0,
    "isMine": 1,
    "title": "帮我分析一下小米汽车的前景",
    "useKnowledge": 0,
    "onlyKnowledge": 0,
    "searchRange": "web"
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	操作码	none
» v	string	true	none	版本号	none
» msg	string	true	none	提示信息	none
» data	object	true	none	数据内容	none
»» status	integer	true	none	会话状态	1: '正在进行中', 2: '正常结束', 3: '用户主动结束', 4: '失败结束', 5: '排队等待中'
»» thinking	string	true	none	思考模式	none
»» workflow	string	true	none	执行模式	none
»» message	string	true	none	当前会话状态说明	none
»» content	string	true	none	当前会话标题	none
»» time	string	true	none	排队时长，提示文字	none
»» thinkingWorkflowName	string	true	none	会话模式	none
»» pptUrl	string	true	none	导出ppt链接	none
»» wavUrl	string	true	none	导出音频链接	none
»» htmlUrl	string	true	none	导出网页链接	none
»» wavScriptUrl	string	true	none	导出音频剧本链接	none
»» isShare	integer	true	none	是否已分享	none
»» isMine	integer	true	none	是否是我的会话	none
»» title	string	true	none	当前会话标题	none
»» useKnowledge	integer	true	none	是否使用了知识库	none
»» onlyKnowledge	integer	true	none	是否只使用了知识库	none
»» searchRange	string	true	none	搜索范围	none

GET 查询会话的历史内容消息

GET /api/conversation/history

倒序向上查询最近n个问题的报告内容

请求参数

名称	位置	类型	必选	说明
sessionId	query	string	是	none
questionId	query	string	否	只查询某个问题的内容
pageSize	query	string	是	每页数量（查询最近n个问题）
pageNo	query	string	是	页码
x-api-key	header	string	是	none

返回示例

200 Response

{
  "code": 200,
  "v": "0.0.913",
  "msg": "成功",
  "data": [
    {
      "id": 37575,
      "questionId": 0,
      "sessionId": "3121642f186242479b575d72fec3b5d0",
      "roleType": "user",
      "contentType": "text",
      "content": "你好",
      "others": {
        "user_id": 38,
        "team_id": 0,
        "only_knowledge": 0,
        "search_range": "web",
        "call_module": "application.deep_search.deepresearch_long",
        "call_func": "search",
        "modify_report_struct": 0,
        "knowledge_id": [],
        "doc_id": []
      },
      "createTime": "2025-07-02 09:52:50",
      "answers": [
        {
          "id": 37578,
          "questionId": 37575,
          "sessionId": "3121642f186242479b575d72fec3b5d0",
          "roleType": "system",
          "contentType": "text",
          "content": "您好，Desearch是一款 AI 驱动的深度研究辅助平台，支持普通模式、深度模式、行业研究与专家模式四大研究路径，覆盖从快速理解到系统分析、再到超万字级专家报告生成的全过程。用户可根据任务需求选择不同研究深度，通过多轮推理与多源数据整合，高效完成企业分析、市场洞察、招商研究等复杂研究任务。",
          "others": {},
          "createTime": "2025-07-02 09:52:55",
          "answers": null,
          "msg": ""
        }
      ],
      "msg": ""
    },
    {
      "id": 37540,
      "questionId": 0,
      "sessionId": "3121642f186242479b575d72fec3b5d0",
      "roleType": "user",
      "contentType": "text",
      "content": "帮我分析一下小米汽车的前景",
      "others": {
        "user_id": 38,
        "team_id": 0,
        "only_knowledge": 0,
        "search_range": "web",
        "call_module": "application.deep_search.deepresearch_long",
        "call_func": "search",
        "modify_report_struct": 1,
        "knowledge_id": [],
        "doc_id": [],
        "modify_report_struct_list": [
          {
            "first_name": "财务健康度与盈利潜力验证",
            "second_name": [
              "季度亏损收窄与毛利率上升的财务指标解读",
              "单车亏损4.5万元的成本结构拆解",
              "产能爬坡对规模效应的量化影响测算"
            ],
            "words_count": 1500,
            "order": 1
          },
          {
            "first_name": "智能驾驶技术迭代路径分析",
            "second_name": [
              "全栈自研算法与激光雷达融合方案的技术验证",
              "城市NOA功能实测里程数据与接管率表现",
              "Xiaomi Pilot 4.0系统向HyperOS智驾的演进逻辑"
            ],
            "words_count": 2000,
            "order": 2
          },
          {
            "first_name": "供应链深度绑定与产能规划",
            "second_name": [
              "宁德时代/比亚迪双源电池供应体系稳定性评估",
              "9100吨一体化压铸设备带来的成本降幅实证",
              "北京工厂30万辆年产能的爬坡节奏预测"
            ],
            "words_count": 1800,
            "order": 3
          },
          {
            "first_name": "产品矩阵差异化竞争策略",
            "second_name": [
              "SU7轿跑与YU7 SUV的定价区间重叠度分析",
              "用户画像交叉风险与品牌认知转型挑战",
              "800V碳化硅平台对充电效率提升的实际数据"
            ],
            "words_count": 1800,
            "order": 4
          },
          {
            "first_name": "生态系统协同效应验证",
            "second_name": [
              "2.1亿台IoT设备互联的落地场景实现度",
              "澎湃OS在车机协同中的算力分配瓶颈",
              "智能座舱研发成本分摊机制的经济性测算"
            ],
            "words_count": 1500,
            "order": 5
          },
          {
            "first_name": "市场反馈与用户行为洞察",
            "second_name": [
              "72小时盲订9.8万辆订单的质量验证",
              "首批试驾用户43%转化率的归因分析",
              "百度指数120万+日均搜索量的舆情特征"
            ],
            "words_count": 1200,
            "order": 6
          },
          {
            "first_name": "风险预警与应对能力评估",
            "second_name": [
              "碳酸锂价格波动对毛利率的敏感性测试",
              "品牌溢价能力不足导致的定价策略失效风险",
              "新能源补贴退坡对价格带冲击的缓冲空间"
            ],
            "words_count": 1400,
            "order": 7
          },
          {
            "first_name": "行业专家观点交叉验证",
            "second_name": [
              "产能爬坡与交付周期延长的矛盾解决路径",
              "智能驾驶技术代际差异的客观量化对比",
              "生态优势向市场竞争力的转化效率评估"
            ],
            "words_count": 1200,
            "order": 8
          }
        ]
      },
      "createTime": "2025-07-02 09:15:08",
      "answers": [
        {
          "id": 37541,
          "questionId": 37540,
          "sessionId": "3121642f186242479b575d72fec3b5d0",
          "roleType": "system",
          "contentType": "thinking",
          "content": "好的，我现在需要处理用户的任务，帮他分析小米汽车的前景，并生成三个搜索查询。用户是汽车行业分析师，所以我得结合他的专业背景来考虑。首先，我要理解他的原始查询意图。他想了解小米汽车的未来发展，可能需要详细的数据和行业分析。\n\n接下来，查看提供的上下文信息，里面有几个网页内容，提到了小米的销量增长、技术投入、产能扩张，还有面临的挑战，比如产能瓶颈和竞争加剧。这些信息可以帮助我确定哪些方面是分析师关注的，比如市场竞争力、供应链管理、技术研发等。\n\n然后，根据用户的职业背景，汽车行业分析师可能更关注市场趋势、竞争分析、供应链、技术发展、政策影响等。因此，改写查询时需要包含这些专业术语，比如“市场竞争力分析”、“供应链稳定性”、“产能爬坡效率”等。\n\n现在要考虑生成三个独特的查询。第一个可以关注市场竞争力，结合最近的销售数据和产品线扩展。第二个可以涉及供应链和产能问题，这些都是影响前景的重要因素。第三个可能需要包括技术研发和行业政策，比如自动驾驶法规和电池技术，这些都是当前行业的热点。\n\n还要注意时间范围，用户没有提到“最近”，所以默认一年内。但根据提供的网页内容，有些信息是2025年的，所以可能需要包含最新的数据。另外，确保每个查询都有不同的侧重点，避免重复。例如，一个侧重市场表现，一个侧重供应链和技术，另一个侧重政策和竞争环境。\n\n最后，提取核心研究对象，应该包括小米汽车、市场竞争力、供应链管理、智能驾驶技术等。确保这些关键词出现在查询中，提高搜索的精准度。\n",
          "others": {
            "id": "02175141891554132fb843e68f76107d322c5ae4adac16347373e",
            "title": "思考搜索条件"
          },
          "createTime": "2

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	操作码	none
» v	string	true	none	当前版本号	none
» msg	string	true	none	提示文字	none
» data	[object]	true	none	数据内容	none
»» id	integer	false	none	问题ID	none
»» questionId	integer	false	none	当前回答的问题ID	none
»» sessionId	string	false	none	会话ID	none
»» roleType	string	false	none	角色类型	none
»» contentType	string	false	none	内容类型	none
»» content	string	false	none	回答内容	none
»» others	object	false	none	额外数据类型	none
»»» user_id	integer	true	none		none
»»» team_id	integer	true	none		none
»»» only_knowledge	integer	true	none		none
»»» search_range	string	true	none		none
»»» call_module	string	true	none		none
»»» call_func	string	true	none		none
»»» modify_report_struct	integer	true	none		none
»»» knowledge_id	[string]	true	none		none
»»» doc_id	[string]	true	none		none
»»» modify_report_struct_list	[object]	true	none		none
»»»» first_name	string	true	none		none
»»»» second_name	[string]	true	none		none
»»»» words_count	integer	true	none		none
»»»» order	integer	true	none		none
»» createTime	string	false	none	创建时间	none
»» answers	[object]	false	none	回答列表	none
»»» id	integer	true	none		none
»»» questionId	integer	true	none		none
»»» sessionId	string	true	none		none
»»» roleType	string	true	none		none
»»» contentType	string	true	none		none
»»» content	string	true	none		none
»»» others	object	true	none		none
»»»» keywords	[string]	true	none		none
»»»» web_infos	[object]	true	none		none
»»»»» url	string	true	none		none
»»»»» title	string	true	none		none
»»»»» push_time	integer	true	none		none
»»»» totals	integer	true	none		none
»»»» id	string	true	none		none
»»»» title	string	true	none		none
»»» createTime	string	true	none		none
»»» answers	null	true	none		none
»»» msg	string	true	none		none
»» msg	string	false	none	提示文字	none

POST 根据会话ID接流式输出接口

POST /api/conversation/re_chat

Body 请求参数

{
  "sessionId": "3121642f186242479b575d72fec3b5d0",
  "questionId": "37540"
}

请求参数

名称	位置	类型	必选	中文名	说明
x-api-key	header	string	是		none
body	body	object	否		none
» sessionId	body	string	是	会话ID	none
» questionId	body	string	否	问题ID	非必传，传入后则去查询固定问题的回答流式

返回示例

[
  {
    "type": "pong",
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "questionId": 37540
  }
]

[
  {
    "others": {
      "id": "02175141891554132fb843e68f76107d322c5ae4adac16347373e"
    },
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "thinking",
    "thinking": "好的"
  }
]

[
  {
    "others": {
      "keywords": [
        "帮我分析一下小米汽车的前景",
        "2025年小米汽车SU7与YU7车型市场竞争力及产能爬坡效率对比分析报告",
        "小米汽车供应链稳定性与800V碳化硅高压平台技术迭代对2026年交付目标的影响研究",
        "智能驾驶政策趋严背景下小米汽车L5级自动驾驶研发进展与行业竞品对比（2025-2026）"
      ]
    },
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "workflow",
    "workflow": "思考与优化搜索条件..."
  }
]

[
  {
    "others": {},
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "text",
    "text": "汽车竞争力全景透视"
  }
]

[
  {
    "others": {},
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "link",
    "link": [
      {
        "url": "https://m.toutiao.com/article/7483384295797621298/",
        "title": "小米：2024 年营收创新高 汽车业务向好",
        "id": 1,
        "push_time": 1742361180000,
        "file_type": "",
        "point_id": "",
        "page_no": "",
        "doc_name": "",
        "is_rag": 0,
        "media_label": ""
      },
      {
        "url": "https://baijiahao.baidu.com/s?id=1821921688291185938",
        "title": "小米SU7汽车成本全面解析，蓝盛高科关注高新科技发展趋势",
        "id": 2,
        "push_time": 1737519900000,
        "file_type": "",
        "point_id": "",
        "page_no": "",
        "doc_name": "",
        "is_rag": 0,
        "media_label": "其他"
      },
      {
        "url": "https://m.sohu.com/a/808961511_121976979/?pvid=000115_3w_a",
        "title": "小米汽车的产能爬坡，会否成为其发展的瓶颈问题？",
        "id": 3,
        "push_time": 1726299120000,
        "file_type": "",
        "point_id": "",
        "page_no": "",
        "doc_name": "",
        "is_rag": 0,
        "media_label": "其他商业媒体(未许可)"
      }
    ]
  }
]

[
  {
    "others": {},
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "picture",
    "picture": [
      {
        "id": "http://zeelin/ik.png",
        "url": "http://zeelin.oss-cn-hangzhou.aliyuncs.com/deepseek_research/docs/normal_model_pic/4a095552c1d8f2dec775b442ba9f888d.png"
      },
      {
        "id": "http://zeelin/sl.png",
        "url": "http://zeelin.oss-cn-hangzhou.aliyuncs.com/deepseek_research/docs/normal_model_pic/1e5849493f9ab4bf861f4b10b3aa975d.png"
      }
    ]
  }
]

[
  {
    "others": {},
    "questionId": 37540,
    "sessionId": "3121642f186242479b575d72fec3b5d0",
    "type": "chapter_editor",
    "chapter_editor": [
      {
        "first_name": "财务健康度与盈利潜力验证",
        "second_name": [
          "季度亏损收窄与毛利率上升的财务指标解读",
          "单车亏损4.5万元的成本结构拆解",
          "产能爬坡对规模效应的量化影响测算"
        ],
        "words_count": 1500,
        "order": 1
      },
      {
        "first_name": "智能驾驶技术迭代路径分析",
        "second_name": [
          "全栈自研算法与激光雷达融合方案的技术验证",
          "城市NOA功能实测里程数据与接管率表现",
          "Xiaomi Pilot 4.0系统向HyperOS智驾的演进逻辑"
        ],
        "words_count": 2000,
        "order": 2
      },
      {
        "first_name": "供应链深度绑定与产能规划",
        "second_name": [
          "宁德时代/比亚迪双源电池供应体系稳定性评估",
          "9100吨一体化压铸设备带来的成本降幅实证",
          "北京工厂30万辆年产能的爬坡节奏预测"
        ],
        "words_count": 1800,
        "order": 3
      },
      {
        "first_name": "产品矩阵差异化竞争策略",
        "second_name": [
          "SU7轿跑与YU7 SUV的定价区间重叠度分析",
          "用户画像交叉风险与品牌认知转型挑战",
          "800V碳化硅平台对充电效率提升的实际数据"
        ],
        "words_count": 1800,
        "order": 4
      },
      {
        "first_name": "生态系统协同效应验证",
        "second_name": [
          "2.1亿台IoT设备互联的落地场景实现度",
          "澎湃OS在车机协同中的算力分配瓶颈",
          "智能座舱研发成本分摊机制的经济性测算"
        ],
        "words_count": 1500,
        "order": 5
      },
      {
        "first_name": "市场反馈与用户行为洞察",
        "second_name": [
          "72小时盲订9.8万辆订单的质量验证",
          "首批试驾用户43%转化率的归因分析",
          "百度指数120万+日均搜索量的舆情特征"
        ],
        "words_count": 1200,
        "order": 6
      },
      {
        "first_name": "风险预警与应对能力评估",
        "second_name": [
          "碳酸锂价格波动对毛利率的敏感性测试",
          "品牌溢价能力不足导致的定价策略失效风险",
          "新能源补贴退坡对价格带冲击的缓冲空间"
        ],
        "words_count": 1400,
        "order": 7
      },
      {
        "first_name": "行业专家观点交叉验证",
        "second_name": [
          "产能爬坡与交付周期延长的矛盾解决路径",
          "智能驾驶技术代际差异的客观量化对比",
          "生态优势向市场竞争力的转化效率评估"
        ],
        "words_count": 1200,
        "order": 8
      }
    ]
  }
]

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

Desearch API使用文档

Desearch#

Authentication#

对外开放的接口#

POST 创建一个会话的任务#

请求参数#

返回结果#

返回数据结构#

GET 查询我的会话列表#

请求参数#

返回结果#

返回数据结构#

GET 查询会话当前状态#

请求参数#

返回结果#

返回数据结构#

GET 查询会话的历史内容消息#

请求参数#

返回结果#

返回数据结构#

POST 根据会话ID接流式输出接口#

请求参数#

返回结果#

Desearch

Authentication

对外开放的接口

POST 创建一个会话的任务

请求参数

返回结果

返回数据结构

GET 查询我的会话列表

请求参数

返回结果

返回数据结构

GET 查询会话当前状态

请求参数

返回结果

返回数据结构

GET 查询会话的历史内容消息

请求参数

返回结果

返回数据结构

POST 根据会话ID接流式输出接口

请求参数

返回结果