批量跑图生 3D,怎么重试才不重复提交?
实测 TRELLIS 的 202 和 400 响应、八个 worker 竞争、超时处理与 GLB 下载。附代码、截图和成本核算。

同一张图、同一个种子,向 TRELLIS 发两份请求。纹理尺寸 1024 的请求先返回 202,后来拿到 GLB。改成 777,接口直接返回 HTTP 400,没有任务 ID。两种结果应走不同的重试路径。我们还用 SQLite 让八个本地 worker 竞争一条任务,另模拟了提交后未收到 ID 的超时。下面用真实响应和本地状态记录说明,怎样让批量任务继续跑,同时避免重复生成。
先说结论
- 真实 TRELLIS 请求传
texture_size: 1024,收到 HTTP 202。同一 ID 查询九次后完成,拿到 1,852,468 字节、17,608 面的 GLB。 - 相同路线、图片和种子下,
texture_size: 777返回 HTTP 400,无任务 ID。错误列出字段可接受的 512、1024 和 2048。 - 本地八个 worker 竞争同一行,只有一个抢到提交资格。相同任务键使用不同参数会被拒绝。模拟未收到 ID 的超时后,也无法再次抢占。
- HTTP 记录给出请求数和结果。实扣费用需要用对应组织的结算记录填写。
区分参数被拒、查询失败与提交结果不明
第一份真实请求用公开 TRELLIS 示例图、种子 77 和纹理尺寸 1024。第二份只把尺寸换成 777。前者返回服务端 ID,可以继续查状态。后者没有可查的 ID。更正参数前,先在应用记录里留住原始拒绝原因。如果任务键绑定一份不可变请求,就给修正后的版本另建键。 SandBase Run API · TRELLIS 参数

截图里的状态来自真实 HTTP 响应。拒绝请求没有 ID,成功受理的请求用同一 ID 查了九次。
| 情况 | 后续动作 | 是否发新生成 POST |
|---|---|---|
| 202 且有任务 ID | 保存 ID,轮询 | 否 |
| 400,字段不支持 | 修正参数,检查后排新版本 | 仅给修正后的任务 |
| GET 超时或临时失败 | 继续查询同一 ID | 否 |
| POST 结果不明,无 ID | 标记未知并核对原始请求 | 等核对 |
| 生成完成,文件未通过验收 | 记录资产缺陷,考虑修复或再跑 | 确实要新生成时才发 |
第三种是只读状态请求,可以在已存 ID 上重试。第四种更棘手。服务端可能已经受理,客户端却没收到响应。本地锁可以阻止另一个 worker 再处理同一条记录。外部 POST 是否幂等,需要看接口是否明确提供支持。结果不确定时把它保留给对账处理,避免重新排队后无声多跑一次。
用本地键锁定请求和提交资格
队列记录应用任务键、规范化参数、状态、可选的服务端 ID 和错误。抢占用条件 SQL 更新。只有 queued 的行才可改成 submitting。worker 要检查实际更新了几行,抢到一行才继续。其他 worker 看见行状态已经变了,就跳过提交。

本地测试没有发线上请求。未知状态来自模拟的提交超时。
八个 worker 各用独立 SQLite 连接,竞争同一条排队记录。一个成功,七个被挡住。用同一键登记不同参数时也报错。另把示例连续跑两遍,输出一致。示例里一条从 pending 到 running 和 completed,一条记录参数拒绝,一条记录无 ID 的未知状态。这三种最终状态均不能再抢占。结果用于验证本地状态和抢占逻辑,分布式队列还有自己的故障边界。
把以下内容保存为 ledger.py。只用 Python 标准库。完成任务的 ID 是本地演示值,代码没有 HTTP 调用。线上实验由另一段客户端记录。
import argparse
import hashlib
import json
import sqlite3
SCHEMA = """
CREATE TABLE IF NOT EXISTS job (
key TEXT PRIMARY KEY,
payload TEXT NOT NULL,
state TEXT NOT NULL,
run_id TEXT UNIQUE,
error TEXT
);
"""
def register(db, key, payload):
serialized = json.dumps(payload, sort_keys=True, separators=(",", ":"))
with db:
db.execute("INSERT OR IGNORE INTO job VALUES (?, ?, 'queued', NULL, NULL)",
(key, serialized))
prior = db.execute("SELECT payload FROM job WHERE key=?", (key,)).fetchone()[0]
if prior != serialized:
raise ValueError("Key reused with a different payload")
def claim(db, key):
with db:
return db.execute("UPDATE job SET state='submitting' WHERE key=? AND state='queued'",
(key,)).rowcount == 1
def receive(db, key, state, run_id=None, error=None):
with db:
updated = db.execute("""
UPDATE job SET state=?,run_id=?,error=? WHERE key=? AND state='submitting'
""", (state, run_id, error, key)).rowcount
if updated != 1:
raise ValueError("Unexpected state during submission")
def poll_result(db, key, run_id, state, error=None):
with db:
updated = db.execute("""
UPDATE job SET state=?,error=? WHERE key=? AND run_id=?
AND state IN ('pending','running')
""", (state,error,key,run_id)).rowcount
if updated != 1:
raise ValueError("Run ID or state mismatch during poll")
def demo(database):
with sqlite3.connect(database) as db:
db.row_factory = sqlite3.Row
db.executescript(SCHEMA)
good = {"model":"trellis/trellis","image":"public-example","texture_size":1024}
bad = {**good, "texture_size":777}
for key,payload in [("recorded-complete",good),("invalid-size",bad),("lost-submit",good)]:
register(db,key,payload)
if claim(db,"recorded-complete"):
receive(db,"recorded-complete","pending","recorded-demo-id")
poll_result(db,"recorded-complete","recorded-demo-id","running")
poll_result(db,"recorded-complete","recorded-demo-id","completed")
if claim(db,"invalid-size"):
receive(db,"invalid-size","rejected",error="HTTP 400: unsupported texture_size")
if claim(db,"lost-submit"):
receive(db,"lost-submit","unknown",error="Simulated timeout before receiving an ID")
rows = []
for row in db.execute("SELECT key,payload,state,run_id,error FROM job ORDER BY key"):
record = dict(row)
record["payload_sha256"] = hashlib.sha256(record.pop("payload").encode()).hexdigest()
record["second_claim_allowed"] = claim(db, record["key"])
rows.append(record)
print(json.dumps(rows, indent=2))
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("--database", default="retry-demo.sqlite")
demo(parser.parse_args().database)python3 ledger.py --database retry-demo.sqlite > first.json
python3 ledger.py --database retry-demo.sqlite > second.json
cmp first.json second.json第一次用一个新的数据库文件名。输出 rejected、unknown 和 completed,三条的 second claim 都为 false。第二次输出相同。正式 worker 要先记录抢占结果,再发 POST。如果重启后看到 submitting 且没有 ID,应调查这一轮已经发生了什么。这个状态与从未处理的 queued 要分别保留。
把费用挂在实际尝试和验收结果上
一个批次里有应用任务、服务端任务和最后合格的交付件。单纯按 HTTP 次数算,会把状态查询与新生成放到一起。同一 ID 的 GET 是状态读。新 POST 可能产生新任务。即使生成完成,资产也可能需要修复或重跑。报表里可以明确这些分母。
| 字段 | 来源 | 能回答的问题 |
|---|---|---|
| 应用键和参数哈希 | 队列 | worker 尝试的是哪一版? |
| 服务端任务 ID | 受理响应 | 哪条状态与结算记录属于这次尝试? |
| 实扣金额和币种 | 组织结算 | 实际结算了多少? |
| 文件与画面验收 | 资产流程 | 结果能否交付? |
| 修复投入 | 本地工作记录 | 还花了多少工才能用? |
项目有预算时,可先估算允许新提交的费用,再与实际账单核对。尚未确认的金额保留未知,等待结算。模型页面的标价可能对应当时展示的配置,账单才说明该次实际选项和组织结算。两次生成只交付一份资产时,合格件成本要计入两次已结算的生成费用,以及有记录的修复工作。 预算图生 3D 实测
完成后核对收到的资产

真实成功文件为 1,852,468 字节、17,608 个三角面和一张内嵌图,验证器报告零错误、零警告。
成功任务只有一个输出。我们下载文件,核对 GLB 头、网格和内嵌图片,并在 Three.js 渲染。可以把输出哈希和验证报告挂到任务记录上。若批次要求人物姿态或某个部件,另保留视觉决策。模型任务 completed 只说明生成阶段结束。 GLB 自动验收
可以从 TRELLIS 图生 3D 的合法参数开始,再在可控测试中验证拒绝输入。批量开启前,模拟提交中断,确认第二个 worker 抢不到同一条记录,再测试状态查询临时失败。 单次任务的后台接入实测 有提交、恢复和下载代码,批处理可以在这条路径外加上自己的队列与结算记录。
留出待对账的队列
把最后尝试时间和收到的响应留给负责处理的人。如果找回服务端任务,绑定原 ID 后恢复轮询。若确认请求没有受理,再按项目预算排新的尝试。每次决定都留在日志中。把未知状态直接改回 queued,会绕开原先防重逻辑。
待核对任务数和实际费用分别统计。未知任务太多时,可以临时收紧新提交,继续轮询已知 ID。等记录核实完,再按剩余预算恢复。这样能继续处理已受理的结果,也保留每笔费用的来源。
每个生产批次可以把任务键、重试原因与最后一次结算一起导出,给运营和开发用同一份数据。排查时先按任务键看是否有多次提交,再按服务端 ID 看每条响应,最后用文件哈希确定交付的是哪一次生成。这样即使两个任务使用了相同图片和参数,仍可分别追溯。
需要按等待时间、文件和首屏结果选路线,可以看四条网页 3D API 的 12 次实测。
常见问题
HTTP 400 要立刻重试吗?
先看响应并修改输入。本次 400 是枚举值不支持,原参数再次提交仍然请求同一个非法配置。改好后再用新版本提交。
本地任务键就是 SandBase 的任务 ID 吗?
本地键在提交前创建,服务端 ID 在受理后返回。两个都保存,用服务端 ID 查状态,用本地键控制队列归属。
提交后始终没有拿到 ID 怎么办?
保留原尝试的未知状态,用现有请求记录和服务端记录核对。重启后仍应把它当作待核查的原任务,避免当成全新的请求。
觉得有用?分享给更多人