记录从官方文档实际读到的事实,供实现与排查引用,并把开工时「待服务商文档确认 的五项」逐条落定。实现在 patbond-ai(58 测试)。 要点(详见正文): - **不支持幂等键**:ADR-023 §4 设想的「透传为厂商幂等头」对本供应商不成立, 风险窗口只能由 max_attempts 兜住。但厂商支持 callback_url,孤儿任务会通过 回调把 ID 送回——回调在此供应商上是**孤儿回收通道**而非仅延迟优化, §4「M4 只做轮询」值得据此复评。 - **产物 URL 仅 24 小时有效**(2.5 另有 100 次下载上限):厂商 URL 不能当存储 用,存成 external_url 会变死链。**这对挂起中的存储决策是硬约束**——无论选 本地还是云,都必须在 24 小时内把文件复制到我们自己的存储。 - **两处文档自身的矛盾**已登记并按宽实现:状态枚举在查询文档与回调说明里 不一致(后者多一个 expired);QuotaExceeded 一码两义(排队超限 vs 额度耗尽, 只能按 message 判别)。 - 两个免费收益:last_frame_url 可直接作视频封面(R13 把缩略图列为视频成本项, 实际免费);查询返回 ratio/resolution/fps/duration,Worker 写产物时维度与 时长在手、无需解码,widthPx/heightPx 债在 AI 产物上零成本可修。 - 取消语义:厂商只支持取消 queued 状态,已 running 的任务取消后仍计费。 - 用户提供的两份文档**文件名与内容装反了**(火山错误码.md 里是查询 API), 已按实际内容归档并注明,避免他人按文件名读错。 另:V7 目录种子仍待确认账号实际开通的 model ID——文档里的示例值不能直接当种子, 否则 provider_model_name 会指向无权访问的模型(InvalidEndpointOrModel.NotFound)。 验证:secret-scan exit 0;mkdocs build --strict exit 0(已挂导航)。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -11,6 +11,8 @@ nav:
|
||||
- 发布记录: development/releases.md
|
||||
- 服务器暴露面清单: development/server-exposure.md
|
||||
- CI Runner 部署手册: development/ci-runner-setup.md
|
||||
- 服务商接口:
|
||||
- 火山方舟 Seedance(视频): development/providers/volcengine-seedance.md
|
||||
- 第一迭代:
|
||||
- 进展看板: development/iterations/iteration-1/index.md
|
||||
- 01 任务分解: development/iterations/iteration-1/01-pm-task-breakdown.md
|
||||
|
||||
Reference in New Issue
Block a user