AI Webhook 快速回执：本地202队列与结果查询验收

展开本页目录

开始前准备什么

Python 3.13+ 与独立练习目录；默认离线重放不需要 Key。
发起新请求时使用自己的 apizt Key；先核对当前模型权限和价格，Key 不写入教材。
材料为原创合成样例；相关第三方项目仅作方法参考，真实执行范围以本页记录为准。

核对输入
保存响应
执行本地处理
验收文件和负例

下载本例完整实测资料包

原始输入、真实请求与响应、业务脚本、正反例检查及已生成的结果文件；不含 Key。

1. 准备这份输入，先确定不能猜的字段

把提交回执与任务完成分开，超时状态不冒充成功。先将下面的原创合成材料保存为 input.json；不要一开始接正式客户资料。

本例与已有教程的区别：已有视频异步任务不同，本篇是文字HTTP应用与回调消费

input.json（较长时显示节选，完整文件在资料包）

json

{
  "jobs": [
    {
      "id": "J1",
      "text": "请缩写：展厅周二闭馆"
    },
    {
      "id": "J2",
      "text": "延迟fixture",
      "delay_seconds": 3
    }
  ],
  "timeout_seconds": 1
}

AI Webhook 快速回执：本地202队列与结果查询验收：实际输入与请求参数 — 实际浏览器截图：原创合成输入及本次请求参数；不是第三方软件界面。
查看高清原图

2. 发送一次小请求，保留原始响应

下载并解压资料包，按 README 创建独立 Python 环境。python run.py 默认仅离线复核已保存回执；显式运行 python run.py --live 才发起新请求并可能计费。

模型阶段使用下面的任务约束。若存在预处理，prepared-input.json 是去重、分页收集或过滤后的真实输入；完整原始材料仍保留。识图任务发送实际 JPEG，不把人工真值放入提示词。

对应任务的请求参数说明；完整实际 request-N.json 见资料包

json

{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "只处理给定的虚构演示材料。只输出JSON，job_id、summary。只处理J1的text，不处理延迟fixture，不声称消息已发送。"
    },
    {
      "role": "user",
      "content": "{\n  \"jobs\": [\n    {\n      \"id\": \"J1\",\n      \"text\": \"请缩写：展厅周二闭馆\"\n    },\n    {\n      \"id\": \"J2\",\n      \"text\": \"延迟fixture\",\n      \"delay_seconds\": 3\n    }\n  ],\n  \"timeout_seconds\": 1\n}"
    }
  ],
  "temperature": 0,
  "max_tokens": 1024,
  "provider": {
    "sort": "success_rate"
  },
  "response_format": {
    "type": "json_object"
  }
}

3. 执行本例的本地处理，模型字段还要再验算

以下节选来自这次实际执行的 verify-task.py 分支。完整函数和辅助方法均在资料包；运行 python run.py 会使用原始回执重放这段业务操作，而不是让模型自己宣布成功。

本地提交真实返回202及任务编号；本地查询状态：J1；本地查询状态：J2

verify-task.py · async-job 分支节选，需在完整脚本上下文运行

python

states = {'J1': {'state': 'succeeded', 'output': output}, 'J2': {'state': 'timed_out', 'fixture': True}}
class Handler(BaseHTTPRequestHandler):
    def do_POST(self):
        self.rfile.read(int(self.headers.get('Content-Length', '0')))
        body = b'{"task_id":"J1","state":"queued"}'
        self.send_response(202)
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)
    def do_GET(self):
        body = json.dumps(states[self.path.rsplit('/', 1)[-1]], ensure_ascii=False).encode()
        self.send_response(200)
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)
    def log_message(self, *_):
        pass
server = ThreadingHTTPServer(('127.0.0.1', 0), Handler)
thread = threading.Thread(target=server.serve_forever, daemon=True)
thread.start()
try:
    base = f'http://127.0.0.1:{server.server_port}'
    with urllib.request.urlopen(urllib.request.Request(base + '/jobs', b'{}'), timeout=5) as response:
        check('本地提交真实返回202及任务编号', response.status == 202 and json.loads(response.read())['task_id'] == 'J1')
    for key in ['J1', 'J2']:
        with urllib.request.urlopen(base + '/jobs/' + key, timeout=5) as response:
            got = json.loads(response.read())
        check('本地查询状态：' + key, got['state'] == states[key]['state'])
finally:
    server.shutdown()
    server.server_close()
    thread.join(timeout=5)
result = {'api_result': output, 'local_status_replay': states, 'boundary': 'Local HTTP replay uses the saved real API result; delayed timeout is a labelled fixture'}

4. 查看真实结果、文件与验收记录

本次 8/8 项通过。模型返回与最终业务结果分开保存；以下是本地处理后的 result.json。

最后一次实测时间：2026-10-24T15:12:08.026017+00:00；HTTP 200；请求型号 gpt-4.1-mini；返回型号 gpt-4.1-mini；本次返回用量 122。中断或超时不会补造用量，多个尝试不合并成一次成功。

实际产物：checks.json、result.json。

检查项	本次结果
真实 apizt 响应 HTTP 200	通过
原始响应 content 可直接解析 JSON	通过
事实检查：job_id	通过
事实检查：summary	通过
明确错误的本地反例被验收规则拒绝	通过
本地提交真实返回202及任务编号	通过
本地查询状态：J1	通过
本地查询状态：J2	通过

检查项: 真实 apizt 响应 HTTP 200
本次结果: 通过

检查项: 原始响应 content 可直接解析 JSON
本次结果: 通过

检查项: 事实检查：job_id
本次结果: 通过

检查项: 事实检查：summary
本次结果: 通过

检查项: 明确错误的本地反例被验收规则拒绝
本次结果: 通过

检查项: 本地提交真实返回202及任务编号
本次结果: 通过

检查项: 本地查询状态：J1
本次结果: 通过

检查项: 本地查询状态：J2
本次结果: 通过

verified/result.json（节选）

json

{
  "api_result": {
    "job_id": "J1",
    "summary": "展厅周二闭馆"
  },
  "local_status_replay": {
    "J1": {
      "state": "succeeded",
      "output": {
        "job_id": "J1",
        "summary": "展厅周二闭馆"
      }
    },
    "J2": {
      "state": "timed_out",
      "fixture": true
    }
  },
  "boundary": "Local HTTP replay uses the saved real API result; delayed timeout is a labelled fixture"
}

AI Webhook 快速回执：本地202队列与结果查询验收：真实业务结果 — 浏览器实拍执行报告；原始 API 响应与本地验收分别保存。
查看高清原图

5. 换自己的材料时，先检查失败分支

本地反例用于验证业务边界，已在检查表中明确标记；不能把本地构造的错误状态写成网关真实故障。原始回执及失败尝试不删除。

真实API请求与本地队列验收分别记录；延迟/超时为本地fixture，不声称外部Webhook平台已运行。

只把本篇标注的任务作为本次验收范围。第三方软件、未测模型、工具调用能力和真实用户数据都需要另行验证；没有调用视频生成模型。

本地提交真实返回202及任务编号
本地查询状态：J1
本地查询状态：J2

解压目录中运行；第一条离线，第二条显式发起新请求

python run.py
# 安全设置自己的 tokenba_API_KEY 后，才执行下面这一条
python run.py --live

怎样确认已经完成

真实 apizt 响应 HTTP 200
原始响应 content 可直接解析 JSON
事实检查：job_id
事实检查：summary
明确错误的本地反例被验收规则拒绝
本地提交真实返回202及任务编号
本地查询状态：J1
本地查询状态：J2

常见问题

AI Webhook 快速回执只看 HTTP200 就完成了吗？

还需要按本页独立规则检查事实、缺失项及最终文件。模型阶段成功与本地工作流成功分别记录。

可以不登录其他平台运行本例吗？

可以。本例使用 apizt API 和本地 Python 脚本；离线复核也无需 API Key。第三方软件的原生 UI、插件和账号权限不在本次验收范围。

更换输入后还能沿用本页的通过结果吗？

不能。原始事实断言只适用于本页合成材料。替换输入后必须同步调整 expected、业务规则与负例，再检查输出。

资料来源

展开本页目录

开始前准备什么

Python 3.13+ 与独立练习目录；默认离线重放不需要 Key。
发起新请求时使用自己的 apizt Key；先核对当前模型权限和价格，Key 不写入教材。
材料为原创合成样例；相关第三方项目仅作方法参考，真实执行范围以本页记录为准。

核对输入
保存响应
执行本地处理
验收文件和负例

下载本例完整实测资料包

原始输入、真实请求与响应、业务脚本、正反例检查及已生成的结果文件；不含 Key。

1. 准备这份输入，先确定不能猜的字段

把提交回执与任务完成分开，超时状态不冒充成功。先将下面的原创合成材料保存为 input.json；不要一开始接正式客户资料。

本例与已有教程的区别：已有视频异步任务不同，本篇是文字HTTP应用与回调消费

input.json（较长时显示节选，完整文件在资料包）

json

{
  "jobs": [
    {
      "id": "J1",
      "text": "请缩写：展厅周二闭馆"
    },
    {
      "id": "J2",
      "text": "延迟fixture",
      "delay_seconds": 3
    }
  ],
  "timeout_seconds": 1
}

2. 发送一次小请求，保留原始响应

下载并解压资料包，按 README 创建独立 Python 环境。python run.py 默认仅离线复核已保存回执；显式运行 python run.py --live 才发起新请求并可能计费。

对应任务的请求参数说明；完整实际 request-N.json 见资料包

json

{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "只处理给定的虚构演示材料。只输出JSON，job_id、summary。只处理J1的text，不处理延迟fixture，不声称消息已发送。"
    },
    {
      "role": "user",
      "content": "{\n  \"jobs\": [\n    {\n      \"id\": \"J1\",\n      \"text\": \"请缩写：展厅周二闭馆\"\n    },\n    {\n      \"id\": \"J2\",\n      \"text\": \"延迟fixture\",\n      \"delay_seconds\": 3\n    }\n  ],\n  \"timeout_seconds\": 1\n}"
    }
  ],
  "temperature": 0,
  "max_tokens": 1024,
  "provider": {
    "sort": "success_rate"
  },
  "response_format": {
    "type": "json_object"
  }
}

3. 执行本例的本地处理，模型字段还要再验算

本地提交真实返回202及任务编号；本地查询状态：J1；本地查询状态：J2

verify-task.py · async-job 分支节选，需在完整脚本上下文运行

python

states = {'J1': {'state': 'succeeded', 'output': output}, 'J2': {'state': 'timed_out', 'fixture': True}}
class Handler(BaseHTTPRequestHandler):
    def do_POST(self):
        self.rfile.read(int(self.headers.get('Content-Length', '0')))
        body = b'{"task_id":"J1","state":"queued"}'
        self.send_response(202)
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)
    def do_GET(self):
        body = json.dumps(states[self.path.rsplit('/', 1)[-1]], ensure_ascii=False).encode()
        self.send_response(200)
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)
    def log_message(self, *_):
        pass
server = ThreadingHTTPServer(('127.0.0.1', 0), Handler)
thread = threading.Thread(target=server.serve_forever, daemon=True)
thread.start()
try:
    base = f'http://127.0.0.1:{server.server_port}'
    with urllib.request.urlopen(urllib.request.Request(base + '/jobs', b'{}'), timeout=5) as response:
        check('本地提交真实返回202及任务编号', response.status == 202 and json.loads(response.read())['task_id'] == 'J1')
    for key in ['J1', 'J2']:
        with urllib.request.urlopen(base + '/jobs/' + key, timeout=5) as response:
            got = json.loads(response.read())
        check('本地查询状态：' + key, got['state'] == states[key]['state'])
finally:
    server.shutdown()
    server.server_close()
    thread.join(timeout=5)
result = {'api_result': output, 'local_status_replay': states, 'boundary': 'Local HTTP replay uses the saved real API result; delayed timeout is a labelled fixture'}

4. 查看真实结果、文件与验收记录

本次 8/8 项通过。模型返回与最终业务结果分开保存；以下是本地处理后的 result.json。

实际产物：checks.json、result.json。

检查项	本次结果
真实 apizt 响应 HTTP 200	通过
原始响应 content 可直接解析 JSON	通过
事实检查：job_id	通过
事实检查：summary	通过
明确错误的本地反例被验收规则拒绝	通过
本地提交真实返回202及任务编号	通过
本地查询状态：J1	通过
本地查询状态：J2	通过

检查项: 真实 apizt 响应 HTTP 200
本次结果: 通过

检查项: 原始响应 content 可直接解析 JSON
本次结果: 通过

检查项: 事实检查：job_id
本次结果: 通过

检查项: 事实检查：summary
本次结果: 通过

检查项: 明确错误的本地反例被验收规则拒绝
本次结果: 通过

检查项: 本地提交真实返回202及任务编号
本次结果: 通过

检查项: 本地查询状态：J1
本次结果: 通过

检查项: 本地查询状态：J2
本次结果: 通过

verified/result.json（节选）

json

{
  "api_result": {
    "job_id": "J1",
    "summary": "展厅周二闭馆"
  },
  "local_status_replay": {
    "J1": {
      "state": "succeeded",
      "output": {
        "job_id": "J1",
        "summary": "展厅周二闭馆"
      }
    },
    "J2": {
      "state": "timed_out",
      "fixture": true
    }
  },
  "boundary": "Local HTTP replay uses the saved real API result; delayed timeout is a labelled fixture"
}

5. 换自己的材料时，先检查失败分支

本地反例用于验证业务边界，已在检查表中明确标记；不能把本地构造的错误状态写成网关真实故障。原始回执及失败尝试不删除。

真实API请求与本地队列验收分别记录；延迟/超时为本地fixture，不声称外部Webhook平台已运行。

只把本篇标注的任务作为本次验收范围。第三方软件、未测模型、工具调用能力和真实用户数据都需要另行验证；没有调用视频生成模型。

本地提交真实返回202及任务编号
本地查询状态：J1
本地查询状态：J2

解压目录中运行；第一条离线，第二条显式发起新请求

python run.py
# 安全设置自己的 tokenba_API_KEY 后，才执行下面这一条
python run.py --live

怎样确认已经完成

真实 apizt 响应 HTTP 200
原始响应 content 可直接解析 JSON
事实检查：job_id
事实检查：summary
明确错误的本地反例被验收规则拒绝
本地提交真实返回202及任务编号
本地查询状态：J1
本地查询状态：J2

常见问题

AI Webhook 快速回执只看 HTTP200 就完成了吗？

还需要按本页独立规则检查事实、缺失项及最终文件。模型阶段成功与本地工作流成功分别记录。

可以不登录其他平台运行本例吗？

可以。本例使用 apizt API 和本地 Python 脚本；离线复核也无需 API Key。第三方软件的原生 UI、插件和账号权限不在本次验收范围。

更换输入后还能沿用本页的通过结果吗？

不能。原始事实断言只适用于本页合成材料。替换输入后必须同步调整 expected、业务规则与负例，再检查输出。

AI Webhook 快速回执：本地202队列与结果查询验收

先看结论

开始前准备什么

1. 准备这份输入，先确定不能猜的字段

2. 发送一次小请求，保留原始响应

3. 执行本例的本地处理，模型字段还要再验算

4. 查看真实结果、文件与验收记录

5. 换自己的材料时，先检查失败分支

怎样确认已经完成

常见问题

资料来源

先用这份输入，确认自己的第一份结果

1. 下载完整样例

2. 离线检查业务结果

3. 需要新结果时，再调用 API

AI Webhook 快速回执：本地202队列与结果查询验收

先看结论

开始前准备什么

1. 准备这份输入，先确定不能猜的字段

2. 发送一次小请求，保留原始响应

3. 执行本例的本地处理，模型字段还要再验算

4. 查看真实结果、文件与验收记录

5. 换自己的材料时，先检查失败分支

怎样确认已经完成

常见问题

资料来源

先用这份输入，确认自己的第一份结果

1. 下载完整样例

2. 离线检查业务结果

3. 需要新结果时，再调用 API