取回 Batch 任务结果操作指南

在您成功提交一个 Batch（批量/异步）任务后，系统将在后台异步处理该任务。任务完成后，您需要主动调用接口拉取处理结果。本文档将指导您如何安全、高效地获取 Batch 任务的返回数据。

📌 前提条件

您已成功提交一个 Batch 任务，并获得唯一的 任务 ID（task_id）。

您已通过轮询或回调机制确认该任务状态为 已完成（completed）。

请确保在任务完成后的 30 天内 完成结果拉取，逾期数据将被自动清除。

您仅可以查询和取回当前账号下的任务

🔁 获取任务结果流程

步骤 1：查询任务状态（可选但推荐）

在拉取结果前，建议先确认任务是否已完成：
查询batch任务状态

请求头（需认证）：

✅ 当 status 为 completed 时，即可进行下一步拉取结果。

步骤 2：拉取任务结果

使用任务 ID 调用结果获取接口：

请求头（需认证）：

成功响应（HTTP 200）：

返回格式通常为 JSON 数组，每条记录对应原始输入中的一行数据及其处理结果。

若数据量较大，结果可能以分页或 预签名下载链接（如 CSV 文件） 形式提供（具体取决于服务商实现）。

示例响应（JSON 格式）：

[
  {
    "input_id": "row_1",
    "input_data": { "text": "Hello" },
    "result": { "embedding": [0.1, -0.3, ...] },
    "status": "success"
  },
  {
    "input_id": "row_2",
    "input_data": { "text": "World" },
    "result": { "error": "invalid input" },
    "status": "failed"
  }
]

⚠️ 注意：部分系统可能返回 临时下载链接（如 download_url），该链接通常有有效期（如 1 小时），请尽快下载。

步骤 3：处理与验证结果

验证每条结果的 status 字段，区分成功与失败项。

对失败项可根据 faild 信息进行重试或修正。

建议将结果持久化存储至本地数据库或文件系统，避免重复拉取。

⏳ 结果保留策略

Batch 任务结果自 完成时间起保留 30 天。

超期后系统将自动清理，无法恢复。

未完成的任务不受此限制影响，仍可继续处理。

❓ 常见问题

Q：拉取结果时返回 404？
A：可能原因包括：任务 ID 错误、任务尚未完成、或结果已过期（超过 30 天）。请先通过任务状态接口确认。

Q：结果太大，接口响应慢或超时？
A：大结果集通常会以文件形式提供（如 CSV/JSONL）。请检查响应中是否包含 download_url 字段，并使用该链接下载。

Q：能否多次拉取同一任务的结果？
A：可以。在 30 天保留期内，您可多次调用结果接口，内容保持一致。

📞 技术支持

如遇异常或需定制化结果格式（如指定输出字段、压缩格式等），请联系您的服务商技术支持团队。

💡 提示：建议在业务系统中集成自动轮询 + 结果断点续拉机制，以提升批量任务处理的可靠性与自动化水平。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

请求成功未完成全部pending任务

{
    "batch_id": "a5837901-bcc1-49f4-8b00-c2a39472a971",
    "data": [
        {
            "custom_id": "task_1001",
            "response": {
                "status_code": 200,
                "body": {
                    "code": 1,
                    "data": {
                        "note_id": "68efb1f0000000000703a7ad",
                        "title": "腿姐背诵手册pdf版需要可自取👇",
                        "desc": "图片截取了专题一至专题五✅\n\t\n背诵手册马原部分pdf（共专题24）见下方文件↓\n可下载来看哦❗\n\t\nps：同学如想补全毛中特、史纲、思修和新思想的内容，在各大电商平台搜《冲刺背诵手册》就能买到纸质完整版[买爆R][买爆R][买爆R]\n\t\n#26考研[话题]# #考研政治[话题]# #腿姐[话题]# #背诵手册[话题]# #考研资料分享[话题]# #腿姐陆寓丰[话题]#",
                        "type": "normal",
                        "publish_time": "2025-10-15 22:38:40",
                        "ip_location": "海南",
                        "author": {
                            "id": "65d356a100000000050320f9",
                            "nickname": "跟着腿姐学政治",
                            "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31in6mcal1a5g5q1h2g8muq2ke31joto?imageView2/2/w/120/format/jpg",
                            "red_id": "10885799072"
                        },
                        "stats": {
                            "liked": 2484,
                            "collected": 1777,
                            "comment": 140,
                            "shared": 277
                        },
                        "images": [
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlm5apb52005pejaqghe87p1g4r3rg?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=b17d74ddc020193bf20f3f307dfa0571&t=694eb224",
                                "width": 1200,
                                "height": 1600,
                                "trace_id": "1040g2sg31nlm5apb52005pejaqghe87p1g4r3rg"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g00831nlomstoku5g5pejaqghe87pbk5t7jo?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=b663d9878ddeb3fb11c385d0793b6f2f&t=694eb224",
                                "width": 1197,
                                "height": 1712,
                                "trace_id": "1040g00831nlomstoku5g5pejaqghe87pbk5t7jo"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlomsrg4uk05pejaqghe87pk9o9dgo?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=edab03295a41699d3a7313db8cca30d6&t=694eb224",
                                "width": 1199,
                                "height": 1720,
                                "trace_id": "1040g2sg31nlomsrg4uk05pejaqghe87pk9o9dgo"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g00831nlomstoku605pejaqghe87pprsp89g?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=4fd3b74d1486a4a40295838ab40f662e&t=694eb224",
                                "width": 1203,
                                "height": 1720,
                                "trace_id": "1040g00831nlomstoku605pejaqghe87pprsp89g"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlomsrg4ukg5pejaqghe87pipc7um8?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=49c9e2f92a396fef5a5b05e3392b900b&t=694eb224",
                                "width": 1198,
                                "height": 1715,
                                "trace_id": "1040g2sg31nlomsrg4ukg5pejaqghe87pipc7um8"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlm5apb526g5pejaqghe87p1vbdk70?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=802e5b011f1e2d1b4cb4d525615f656a&t=694eb224",
                                "width": 1198,
                                "height": 1708,
                                "trace_id": "1040g2sg31nlm5apb526g5pejaqghe87p1vbdk70"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlm5apb52205pejaqghe87p0if0boo?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=c6f5f4fd91bcfe59106b4b05724fe40e&t=694eb224",
                                "width": 1199,
                                "height": 1716,
                                "trace_id": "1040g2sg31nlm5apb52205pejaqghe87p0if0boo"
                            },
                            {
                                "url": "https://sns-na-i1.xhscdn.com/1040g2sg31nlm5apb524g5pejaqghe87p1dnie78?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=fdc8d1b02106171d14405e3895714895&t=694eb224",

取回batch任务结果

取回 Batch 任务结果操作指南

📌 前提条件

🔁 获取任务结果流程

步骤 1：查询任务状态（可选但推荐）

步骤 2：拉取任务结果

步骤 3：处理与验证结果

⏳ 结果保留策略

❓ 常见问题

📞 技术支持

请求参数

请求示例代码

返回响应

取回batch任务结果

取回 Batch 任务结果操作指南#

📌 前提条件#

🔁 获取任务结果流程#

步骤 1：查询任务状态（可选但推荐）#

步骤 2：拉取任务结果#

步骤 3：处理与验证结果#

⏳ 结果保留策略#

❓ 常见问题#

📞 技术支持#

请求参数

请求示例代码

返回响应

取回 Batch 任务结果操作指南

📌 前提条件

🔁 获取任务结果流程

步骤 1：查询任务状态（可选但推荐）

步骤 2：拉取任务结果

步骤 3：处理与验证结果

⏳ 结果保留策略

❓ 常见问题

📞 技术支持