获取 ChatGPT LLM Responses 已完成任务列表

接口说明

该接口用于获取已完成但尚未获取结果的任务列表。

如果你使用的是标准模式，且在创建任务时未指定 postback_url，可以通过本接口获取所有已完成任务的 id，然后再调用对应的 Task GET 接口拉取任务结果。

• 标准模式任务最长可能需要 72 小时完成
• 若任务在 72 小时未完成，会被标记为失败，预扣费用将退回
• 若账户余额为负，即使任务执行成功，也无法获取结果

注意： 由于平台 API 的队列同步存在轻微延迟，高并发场景下可能出现短时间列表未及时更新的。 如果你的系统需要每分钟拉取 1000 个任务，建议优使用 pingback / postback 机制；tasks_ready 更适合用于补偿式拉取，例如获取 postback 失败的任务 ID。

请求信息

• 方法：GET
• 路径：/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready
• 完整地址：https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready

计费与调用限制

• 获取已完成任务列表不额外收费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
• 每分钟最多可调用 20 次
• 每次调用最多返回过去 3 天完成的 1000 个任务
• 任务在列表中会一直保留，直到你成功获取结果
• 已拉取的任务不会再次出现在列表中
• 完成后 3 天仍未拉取的任务，也不会出现在列表中

postback_url

如果创建任务时设置了 postback_url，该任务通常不会出现在已完成任务列表中。 只有在向你的服务器回调失败时，该任务才可能出现在本列表中，例如你的服务返回：

• 小于 200 的 HTTP 状态码
• 大于 300 的 HTTP 状态码

响应结构

接口返回 JSON 数据，顶层 tasks 数组保存本次返回的任务信息。

顶层字段说明

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表见 /v3/appendix/errors
status_message	string	通用状态信息，完整列表见 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	本次请求总成本，USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务数组

建议在生产环境中完善异常处理逻辑，针对接口状态码、任务状态码和空结果进行底。

tasks 数组字段说明

字段名	类型	说明
id	string	任务标识符，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000，完整列表见 /v3/appendix-errors/
status_message	string	任务状态说明，完整列表见 /v3/appendix-errors/
time	string	任务执行耗时，单位秒
cost	float	单个任务成本，USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	请求 URL 中携带的参数信息
result	array	结果数组

result 数组字段说明

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

调用示例

curl

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

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)
print(response.json)

TypeScript

import axios from "axios";

// 获取已完成但尚未拉取的任务列表
axios({
 method: "get",
 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",
 },
})
 .then((response) => {
 // 输出返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

结果拉取流程示例

型处理流程如下：

1. 调用 /v3/ai_optimization/chat_gpt/llm_responses/tasks_ready
2. 遍历返回结果中的 result
3. 读取每个中的 endpoint
4. 对 endpoint 发起 GET 请求，获取该任务的最终结果

这类模式适合：

• 未使用 postback_url 的标准拉取流程
• postback 失败后的补偿拉取
• 周期性轮询任务完成状态

响应示例

{
 "version": "0.1.20250526",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1220 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "ai_optimization",
 "function": "llm_responses",
 "se": "chat_gpt"
 },
 "result": []
 }
 ]
}

使用建议

• 若你依赖轮询方式取数，建议控制频率，每分钟 20 次限制
• 若任务规模较大，优使用 postback_url 提升回传效率
• 对返回的 endpoint 建议立即消费，任务 3 天后失效
• 对 tasks_error > 0 或任务级别 status_code >= 40000 的进行告警和重试

常见状态说明

场景	说明
status_code = 20000	请求成功
tasks 为空	当前没有可拉取的已完成任务
任务不在列表中	可能已被拉取、已 3 天，或提交时设置了有效的 postback_url
任务完成但未返回	可能因账户余额为负而无法获取

实用场景

• 轮询已完成任务：批量获取已执行完毕的 LLM 响应任务 ID，构建稳定的异步结果采集链路。
• 补偿拉取回调失败任务：当 postback 因网络或服务异常未送达时，从本接口补捞任务并结果丢失。
• 监控任务生产状态：按分钟检查完成队列数量，评估 AI生成、问答分析等任务的处理吞吐。
• 业务标签追踪结果：结合返回的 tag 字段，把任务结果回写到工单、策略或 SEO 分析流程。
• 批量拉取最终结果：通过 endpoint 字段获取后续结果接口地址，降低自行拼接任务查询路径的复杂度。