工作原理
所有请求都是异步的。你提交任务后,任务进入队列,由 worker 查询目标引擎并提取结果,结果通过 webhook 推送给你,或由你轮询获取。1
提交任务
携带
taskType 和 payload 调用 POST /v1/async/task。你会立即拿到任务 id,状态为 QUEUED。2
查询引擎
worker 领取任务,查询引擎,并提取回答文本、来源以及引擎特有的附加数据。
3
获取结果
如果提供了
webhook.url,我们会把结果 POST 到该地址。否则请轮询 GET /v1/async/task/{id},
直到 status 变为 COMPLETED 或 FAILED。返回内容
无论哪个引擎,每个结果的核心都是同样的结构:string
引擎回答的纯文本。
array
引擎附在回答上的引用,包含
position、url,通常还有 label。Base URL
/health 和 /ready 外,所有端点都需要 Bearer 令牌。
从这里开始
提交你的第一个任务,五分钟内拿到结果。