Qingpu Studio 项目、图片生成与合规检查

Studio 与 Listing 是两个独立产品。Studio 项目围绕共享商品身份组织专业图片、视频的规划与结果,不复制 Listing workspace、资产或渠道草稿。P0 当前只实现 Ozon 商品图片套图执行;单图编辑和专业商品视频执行仍是独立能力。

图片套图生成合同

项目页通过 POST /api/qingpu/studio/projects/:id/generation 提供两个明确动作:

  • {"action":"quote","planId":"...","strategyId":"...","productRevision":12} 返回选中槽位数、阻断槽位数、服务端解析的模型摘要,以及 pricingUnavailable: true。
  • {"action":"confirm","planId":"...","strategyId":"...","productRevision":12} 由服务端冻结 ImageGenerationTaskSpec,创建或复用幂等父任务,并返回逐槽位任务账本。

客户端只能提交 planId、strategyId、productRevision(以及 action)。不得提交或覆盖 Prompt、模型/供应商参数、API Key、凭据、参考 URL、冻结 task spec、asyncSubmissionKey 或 remoteTaskId。服务端会重新加载当前登录用户的项目、商品 revision、Brief、策略卡和证据,再为每个槽位构造规格。

POST /api/qingpu/studio/projects/:id/generation/retry 接收失败项的 taskId 和/或 itemKey。只有原尝试明确进入终态失败后,失败项才会创建新的付费尝试;远程状态未知时继续原远程任务,不轮换提交键。

父任务幂等键为 studio:image-suite:<projectId>:<strategyPlanId>:<strategyId>,并按用户和任务类型唯一约束。刷新页面或重复确认会返回同一父任务,不会重复扣费。每个槽位使用稳定资产身份 generated-plan:<planId>,并保存冻结规格、提交键、远程任务 ID、结果 URL 与审核状态。

报价与上线前提

当前没有权威的图片单价或余额预留事实源。因此报价固定返回 pricingUnavailable: true,且 currency、estimatedTotal、availableBalance、sufficient 全部为 null;接口不会伪造扣费、余额或“扣费成功”。

确认并入队前,服务端必须通过 AINode 异步图片任务能力预检 /v1/images/generations/tasks。若部署返回 404 或 unsupported-endpoint,确认会被阻断。Studio 不安全地回退同步图片接口,因为请求结果不确定时重试可能产生第二次付费生成。上线前必须部署异步网关并完成预检。

执行支持恢复:进程重启后 queued、running 状态和逐槽位账本仍可继续;远程状态未知的槽位继续绑定原远程任务;明确终态失败的槽位可单独重试。项目结果使用 succeeded、partial、failed;部分失败不会回滚已成功资产。文字 QA 沿用引擎的 ok、warn、failed,不伪造额外的审核 block。

项目记录

GET /api/qingpu/studio/projects 接受 search、status、page 和 limit,返回项目摘要以及 total、page、limit。摘要包含商品事实 revision、资产与运行任务数量、证据风险、审核计数和保守的合规状态。

用户路由 /user/studio/projects 把搜索、状态和页码保存在 URL,刷新后可恢复同一筛选视图。/user/studio/projects/:id 恢复商品证据与策略状态。

合规只读模型

GET /api/qingpu/studio/compliance 接受 search、status、page 和 limit;传入 projectId 时返回单个项目及其合规明细。

接口只从以下事实推导结果:

  • CreativeBrief.missingFacts,作为商品证据风险;
  • qingpu_task_items.review_status,作为已有资产审核状态;
  • 已通过 user_id + product_id 关联的当前商品 revision、资产与任务。

汇总状态包括 evidence_block、review_failed、warning、pending、partial、passed 和 unreviewed。passed 只表示已有审核项为 ok,不代表所有平台规则都已检查;缺少审核记录时保持 unreviewed。当前系统没有持久化的资产审核 block 产出,因此 API 不伪造该结论。

该接口不会创建审核任务、消耗额度、修改 Listing 或发布资产。Studio 生成只写 Studio 自有的资产、任务、任务项和项目状态,不写 Listing workspace 或渠道草稿表。