3D 生成请求允许缺省 geometryQuality 并按 standard 计价

- PricingParamView::validate 去掉 geometryQuality 必填，缺省按 standard 计入定价 - 只有显式 detailed 才命中 hdGeometry 加价，缺省不会改变报价 - 新增缺省几何质量的定价用例（v3.1 与 v2.5 两条路径），并把它从必填字段用例里移除 - 同步技术方案：说明该字段允许缺省的原因，v2.5 / P1 / P2 因 provider 不支持该参数而必须允许缺省
2026-09-23 16:24:18 +08:00
parent ffee739774
commit 427b9f19a1
2 changed files with 38 additions and 6 deletions
@@ -66,7 +66,7 @@ canvasCompletion? 画布占位框回填，只在项目资源落点下生效

 **归一在预检之前完成并写回请求**：项目 ID 与素材夹 ID 都 trim，`project` / 旧 `folder-*` 走与图片画布同一个 `normalize_generated_asset_folder_id` 映射到当前 owner 的默认素材夹，素材名走同一个 `resolve_editor_generated_asset_label`（trim + 截断 + 缺省「3D 模型」）。入队的就是归一后的请求，因此预检值 = 队列载荷 = 落库值；模块侧落库原有的 `normalize_editor_generation_default_asset_folders` 继续兜底老队列载荷里的 `project`。

-**定价相关参数在 API 层必填并做组合校验**：`texture`、`textureQuality`、`geometryQuality`、`quad`、`smartLowPoly`、`generateParts` 必须显式给出。`texture=false` 时禁止出现 `textureQuality`，且 `pbr` 必须显式 `false`；`texture=true` 时 `textureQuality` 必填。理由是 provider 的隐式默认值会直接改变价格，一旦依赖默认值，报价与扣费会在“调用方少传字段”时分叉。
+**定价相关参数在 API 层做组合校验**：`texture`、`textureQuality`、`quad`、`smartLowPoly`、`generateParts` 必须显式给出；`geometryQuality` 允许缺省，缺省按 `standard` 计价 —— provider 对 v2.5 / P1 / P2 不支持该参数，v3.x 的缺省也是 `standard`，两边同价，因此只有显式 `detailed` 才命中 `hdGeometry` 加价（写死必填只会让定价表里已有的 v2.5 / P1 / P2 永远不可达）。`texture=false` 时禁止出现 `textureQuality`，且 `pbr` 必须显式 `false`；`texture=true` 时 `textureQuality` 必填。其余会改价的参数仍必须显式给出：provider 的隐式默认值会直接改变价格，一旦依赖默认值，报价与扣费会在“调用方少传字段”时分叉。

 两个 submit 都必须携带 `Idempotency-Key`，复用现有头部校验；缺失或格式非法直接 400，不静默生成键。