跳转到内容

取消任务

POST https://maxaeo.cn/geoapi/geodata/developer/task/cancel

取消一个还在排队的任务。取消成功的任务 status 为 canceled,不扣点数,提交时预占的点数释放。

参数 类型 必填 说明
task_id string 是 提交任务或任务列表返回的任务 ID,最长 64 个字符

请求体只有 task_id 一个字段,多传字段返回 1001。

能操作哪些任务:和查询任务一样,同一用户在个人账户下提交的所有任务,不论用的是哪个 API Key,还是在控制台在线调试提交的。

Terminal window
curl -X POST "https://maxaeo.cn/geoapi/geodata/developer/task/cancel" \
-H "Authorization: Bearer $MAXAEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task_id": "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23"}'

data.ent 是任务对象,和查询任务同结构。按返回的 status 判断结果:

status 含义 点数
canceled 取消成功 不扣,预占的点数释放
running 任务已经开始,没有取消,照常跑完 成功照常扣点
succeeded / failed 任务已经结束,没有取消 按任务本身的结果
  • queued、pending 的任务可以取消。
  • dispatching(交接中)的任务可能暂时取消不了,会原样返回,稍后再调一次;少数情况下 pending 的任务也会这样。只要 status 不是 canceled,就是没取消成功。
  • 没取消成功不是错误,ret 仍是 1,所以一定要看 status。
  • 重复调用不报错,可以放心再调。

取消成功的响应示例:

{
"ret": 1,
"data": {
"ent": {
"thinking": false,
"task_id": "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23",
"platform": "doubao",
"query": "适合程序员的机械键盘推荐",
"status": "canceled",
"answer": "",
"result_json": "",
"share_link": "",
"error_code": "crawl_canceled",
"error_message": "任务已取消",
"started_at": 0,
"finished_at": 1793018460,
"created_at": 1793018425,
"updated_at": 1793018460,
"monitor_date": "2026-10-26",
"priority": 2,
"country": "",
"credits": 0
}
}
}

已取消的任务 error_code 为 crawl_canceled,error_message 是纯文本「任务已取消」,credits 为 0。

已取消的任务不能重试(对它调用重试会原样返回 canceled)。需要重新跑,请重新提交,会得到新的 task_id;task_id 由服务端生成,不能指定。

ret 原因
1001 task_id 缺失或超过 64 个字符,或请求体含未定义的字段
1030 API Key 缺失或无效
1031 任务不存在,或不属于当前用户
-1 服务暂时不可用,任务保持原样,可以再调一次