同步Tripo 3D生成的图片输入与完成结果口径

- 主规范明确图片输入先读字节再上传换 file_token,不把带签名的临时地址交给第三方
- 主规范补完成结果读取口径:由既有任务查询的 result 字段返回,标准消费者仅透传调用方显式给出的 result
- 实施计划把图片输入步骤改写为 file_token 口径,文件表补 storage.rs
- 实施计划新增进展一节,写清已落地步骤、未确认的定价数值与尚未跑通的真实端到端
- 风险一节补 worker 并发位与长任务超时的运维前提
This commit is contained in:
2026-09-21 14:38:20 +08:00
parent 29e554a30c
commit 8a828a43ba
2 changed files with 15 additions and 1 deletions
@@ -47,6 +47,8 @@ source = { kind: "resource", resourceId } | { kind: "asset", assetId }
不接受裸 `input` 字符串、任意远程 URL、data URL,也不接受同时给两个 ID。
服务端按 ID 定点确认归属、解析出对象键后,从私有 OSS 读出字节并**上传 provider 换 `file_token`**,再以显式 `file_token` 提交生成任务:不把带签名的临时地址交给第三方,也不依赖 bucket 对公网可达。签名地址会在异步排队期间过期,且等于把私有桶的临时读取权外泄,因此不作为输入通道。
**结果落点**(两个端点都必填)使用 tagged enum
```text
@@ -84,6 +86,8 @@ ImageToModelResult = { modelArtifact, renderedPreview }
每个 artifact 只携带正式资源引用与对象元数据,不携带 provider 临时 URL。
**完成结果的读取**:3D 生成没有画布读回路径,完成结果由既有任务查询 `/api/runtime/external-generation/jobs/{jobId}``result` 字段返回,形状就是上面的严格 tagged enum。标准消费者此前只回来源身份,现在仅在调用方显式给出 `result` 时透传,其它标准任务行为不变。
## 定价与扣费
定价是**真实扣费**,不是计量占位。Tripo 的计费形态是“底价 + 可叠加 add-on”,现有图片/视频那套“模型 → 档位 → 单价”查表表达不了,因此在同一份定价配置中新增 `model3d` 段,全部以泥点计价: