MarkUDown
Deep Research API — MarkUDown AI 研究 API 文档
POST
/api/deep-research深度研究
抓取你提供的 URL,并由 LLM 将内容综合成一份研究结论,附带来源。
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| query | string | 必填 | — | 研究问题或主题。 |
| urls | array<string> | 必填 | — | 要抓取并分析的来源页面。每个 URL 消耗 1 个积分。 |
| max_tokens | integer | 可选 | 4096 | 生成答案的最大长度(token 数)。 |
| timeout | integer | 可选 | 180 | 超时时间(秒)。 |
| callback_url | string | 可选 | 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
}