Skip to main content
GET
通过统一任务入口提交 ASYNC 模式的业务接口(如 GEO 排名查询、GEO 排名监测、品牌得分检测、推广链接检测等)后,服务端会先返回唯一的 taskId。调用方通过本接口轮询查询任务的实时处理进度并在成功后获取业务结果。
推荐轮询间隔: 建议每隔 10 秒 查询一次本接口。任务未完成前不建议高频请求。

接口速查

请求头

string
required
AIBase 开放平台 API Key,例如 AIBase_xxx。请仅在服务端保存和使用。
string
可选的客户端请求追踪标识。

路径参数

string
required
提交异步任务时由平台返回的唯一任务标识,例如 task_d77143abc87642d4842ff588197faa89

响应参数

integer
required
业务状态码。200 表示查询接口请求成功。
string
required
响应说明。
object
required
任务详情数据。
string
required
任务唯一标识。
integer
required
任务处理状态枚举值(详见下方状态表)。
string
required
任务状态文字说明,如 成功待执行失败 等。
object
业务返回结果。仅在 status = 2(SUCCESS)时返回完整的具体业务数据,字段结构由对应的 apiCode 决定。
integer
required
服务端响应时间戳,单位毫秒。

status 状态码字典

接入注意事项

  1. 不可仅依据固定轮询次数判断:大模型生成与多平台检测耗时受网络和模型并发负载影响,请务必根据返回的 status 状态枚举决定是否结束轮询。
  2. 遵守 10 秒轮询间隔:高频轮询会白白消耗客户端计算与网络资源,并可能触发平台的并发限流规则。
  3. 结合超时熔断控制:在业务侧编写循环等待逻辑时,建议加入最大等待时间(例如 5 分钟),超过时间仍为 status = 1 则主动熔断报警。