1. batch批处理异步接口
无界矩阵系统
  • xiaohongshu-Web-API
    • 短链接转长链接并提取/Short2long
      POST
  • (super)xiaohongshu-App-API (Clear Api)
    • (超级接口)获取小红书搜索商品关键词/Search Goods List
      POST
    • (超级接口)获取小红书商品详情/Get goods detial
      POST
    • (超级接口)获取小红书笔记详情/Get note detial
      POST
    • (超级接口)获取小红书视频详情/Get video detial
      POST
    • (超级接口)获取小红书笔记评论/Get Note Comments
      POST
    • (超级接口)获取小红书搜索笔记关键词/Search Notes List
      POST
    • (超级接口)获取小红书搜索用户关键词/Search User List
      POST
    • (超级接口)获取小红书个人资料/Get User Info
      POST
    • (超级接口)获取小红书个人资料笔记/Get User Info Note
      POST
    • (超级接口)获取小红书个人资料商品/Get User Info Goods
      POST
  • 网页违规检测
    • 网页违规元素检测
      POST
  • batch批处理异步接口
    • 提交batch任务
      POST
    • 查询batch任务状态
      GET
    • 取回batch任务结果
      GET
  1. batch批处理异步接口

取回batch任务结果

GET
https://video.unboundtech.cn/api/batch/batch_result

取回 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 天保留期内,您可多次调用结果接口,内容保持一致。

📞 技术支持#

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

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

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://video.unboundtech.cn/api/batch/batch_result?batch_id=702f8c02-282a-47a8-9c41-010dcb43cfe9' \
--header 'Authorization: Bearer sk-ZmFMwo3JeROCSWtUAzLY4vHd75sIfNab'

返回响应

🟢200成功
application/json
Body

示例
{
    "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",
修改于 2026-01-29 14:29:12
上一页
查询batch任务状态
Built with