获取 ChatGPT LLM 响应已完成任务

GET /v3/ai_optimization/chat_gpt/llm_responses/tasks_ready

本接口使用 GET 方法，请求路径为：

/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready

用于获取已完成但尚未领取的 ChatGPT LLM 响应任务列表。使用标准任务提交方式且未设置 postback_url 时，可通过本接口获取所有已完成任务的 id，再使用任务获取接口领取结果。

标准方式提交的任务最长可能需要 72 小时完成。此时间仍未完成的任务将标记为失败，并退还预扣费用。请注意，当账户余额为负数时，即使任务已成功完成，也无法获取任务结果。

> 提示： 已完成任务队列可能存在少量更新延迟。若系统每分钟需要领取 1000 个任务，建议使用回调通知机制；本接口可用于补获取回调失败任务的 ID。

请求信息

请求方法： GET
请求 URL： https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready
请求体： 无

计费说明

获取已完成任务列表不收取费用。

每个任务在成功领取前都会持续保留在列表中。接口调用限制如下：

每分钟最多调用 20 次；
每次调用最多返回 1000 个任务；
返回最近 3 天完成且尚未领取的任务；
已领取的任务不会再次出现在列表中；
完成 3 天仍未领取的任务不会出现在列表中。

如果提交任务时设置了 postback_url，任务通常不会出现在本接口的列表中。只有当平台向您的服务器推送失败，且服务器返回的 HTTP 状态码小于 200 或大于 300 时，任务才可能重新出现在领取列表中。

本接口不产生调用费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

cURL

bash

curl --location --request GET \
  "https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

Python

python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
response.raise_for_status()

result = response.json()
print(result)

TypeScript

typescript

import axios from "axios";

axios
  .get(
    "https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready",
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    // 处理已完成任务列表
    console.log(response.data);
  })
  .catch((error) => {
    // 处理请求错误
    console.error(error.response?.data || error.message);
  });

响应说明

接口返回 JSON 格式数据，顶层 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	请求级状态码
`status_message`	string	请求级状态说明
`time`	string	请求执行耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量
`tasks`	array	任务信息数组

`tasks` 数组字段

字段	类型	说明
`id`	string	任务标识符，采用 UUID 格式
`status_code`	integer	任务状态码，通常位于 `10000` 至 `60000` 范围
`status_message`	string	任务状态说明
`time`	string	任务处理耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量
`path`	array	请求路径信息
`data`	object	创建任务时传的请求参数
`result`	array	已完成任务信息数组

`result` 数组字段

字段	类型	说明
`id`	string	已完成任务的任务标识符，采用 UUID 格式
`se`	string	创建任务时指定的 LLM 模型
`function`	string	任务类型
`date_posted`	string	任务提交时间，使用 UTC 时间格式
`tag`	string	用户自定义任务标识
`endpoint`	string	用于获取该任务详细结果的 URL

获取到 endpoint 后，应继续调用该地址对应的任务获取接口，以领取任务的完整结果。

响应示例

json

{
  "version": "0.1.20250526",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1220 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0100 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "ai_optimization",
        "chat_gpt",
        "llm_responses",
        "tasks_ready"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "llm_responses",
        "se": "chat_gpt"
      },
      "result": [
        {
          "id": "abcdef01-2345-6789-abcd-ef0123456789",
          "se": "chat_gpt",
          "function": "llm_responses",
          "date_posted": "2025-05-26 12:00:00 +00:00",
          "tag": "seo-batch-001",
          "endpoint": "/v3/ai_optimization/chat_gpt/llm_responses/task_get/abcdef01-2345-6789-abcd-ef0123456789"
        }
      ]
    }
  ]
}

状态码与异常处理

建议客户端同时处理请求级状态码和任务级状态码：

20000：请求成功；
40000 及以上：任务或请求处理失败；
当 result 为空或不存在时，应根据 status_code 和 status_message 记录异常；
对于暂时无法领取的任务，建议采用重试机制，并结合任务 ID 做幂等处理。

完整错误码请参考本平台错误码文档。

实用场景

轮询获取批量完成任务：定期读取已完成任务 ID，再批量领取 LLM 响应，适合不方便部署回调服务的 SEO分析系统。
补偿回调失败任务：筛选未成功推送的任务并重新获取结果，降低异步回调丢失造成的数据缺口。
构建任务状态看板：根据已完成任务列表统计不同模型、标签和提交批次的处理进度，便于监控 SEO 数据生产任务。
驱动后续分析流程：获取完成任务的 endpoint 后自动领取结果，并触发意图识别、质量评估或竞品摘要分析。
执行定时数据同步：按最近三天的完成任务进行增量拉取，重复处理已领取结果，提高数据仓库同步效率。

获取 ChatGPT LLM 响应已完成任务 ​

请求信息 ​

计费说明 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应说明 ​

顶层字段 ​

tasks 数组字段 ​

result 数组字段 ​

响应示例 ​

状态码与异常处理 ​

实用场景 ​