任务详情

API PLAYGROUND

任务详情

GET /api/agent/tasks/:taskId

环境配置

Base URL 和 Authorization 修改后自动保存，供本站 Playground 共用。

Base URLAPI 服务根地址；不要填写接口路径，请求路径为 /api/agent/tasks/:taskId。

请求头配置

Authorization 必填用于鉴权和限定任务查询范围的 API Key，格式为 Bearer <API_KEY>；仅保存在当前浏览器。如何鉴权？

路径参数

taskId必填 · string查询当前 API Key 作用域内的任务；每次点击查询获取一次最新状态。

任务状态

发送查询后，在这里查看 HTTP 状态码和响应内容。

GET /api/agent/tasks/:taskId

Base URL： https://api.dajiaoai.com

调用前请阅读鉴权说明和智能生图服务概览。

• 方法：GET
• 路径：/api/agent/tasks/:taskId

示例请求

curl https://api.dajiaoai.com/api/agent/tasks/6844db73f1d0c0e74f5e9d01 \
  -H "Authorization: Bearer djo_xxx"

成功响应

{
  "success": true,
  "task": {
    "taskId": "6844db73f1d0c0e74f5e9d01",
    "customerId": "6844db10f1d0c0e74f5e9cff",
    "applicationId": "6844db40f1d0c0e74f5e9d00",
    "apiKeyId": "6844db50f1d0c0e74f5e9d02",
    "type": "agent",
    "content": "请画一个三角形",
    "imgUrl": null,
    "imgUrls": null,
    "status": "finished",
    "artifactUrl": "https://dl.easeplay.vip/dajiao-open/dev/mcp/.../result.algeo",
    "createdAt": "2026-06-08T10:00:00.000Z",
    "updatedAt": "2026-06-08T10:00:05.000Z"
  }
}

错误响应

状态码	原因
404	任务不存在，或不属于当前 API Key 作用域

状态说明

• created：任务已入库，等待 worker 领取
• running：worker 已开始执行
• finished：任务完成，artifactUrl 可读
• error：任务失败

轮询建议

• 前 30 秒每 2 秒轮询一次任务详情接口
• 30 秒后降到每 5 秒一次
• 命中 finished 或 error 后停止轮询

产物说明

任务完成后，artifactUrl 指向大角几何工程文件（.algeo）。