MarkUDown

Deep Research API — MarkUDown AI 研究 API 文档

POST/api/deep-research

深度研究

抓取你提供的 URL,并由 LLM 将内容综合成一份研究结论,附带来源。

参数类型必填默认值描述
querystring必填—研究问题或主题。
urlsarray<string>必填—要抓取并分析的来源页面。每个 URL 消耗 1 个积分。
max_tokensinteger可选4096生成答案的最大长度(token 数)。
timeoutinteger可选180超时时间(秒)。
callback_urlstring可选null任务完成时接收结果(POST)的 webhook URL。

请求

{
  "query": "Which books in the catalogue cost less than £20?",
  "urls": [
    "https://books.toscrape.com/",
    "https://books.toscrape.com/catalogue/page-2.html"
  ]
}

响应

// POST returns { "success": true, "id": "abc123", "url": "/api/deep-research/abc123" }
// Poll GET /api/deep-research/{id} — "data" when completed:
{
  "success": true,
  "research": "## Books under £20\n\n...",
  "sources": [
    "https://books.toscrape.com/",
    "https://books.toscrape.com/catalogue/page-2.html"
  ],
  "pages_analyzed": 2
}