用途:在生成图中放置像素级准确的标准 logo。LLM(含 Gemini Pro)会涂抹复杂 logo 的渐变、丢文字、错排元素,因此该流程不让模型生成 logo,而是在生成后由服务器合成。
主要能力:资产库设 canonicalLogoUrl(角色 logo_reference),通过 set-canonical-logo --libraryId=<id> --assetId=<asset-id> 指定。生成预设可带 includeLogo,调用时传 includeLogo 可覆盖预设。开启后提示词会要求右上角留干净区域。server/lib/image-processing.ts 的 compositeLogo()(Sharp)加载 logo PNG/SVG,缩放到约图宽 16%(不小于 120px),内边距约较小边 3.5%(不小于 24px),合成到右上角,输出 PNG 保留透明。
预设骨架:settings.skeletonSpec 含 background、可选 mask、contentMode(fill/cutout)、contentRegion、dropShadow、foreground 层。骨架已有 source 为 canonicalLogo 的前景层时,includeLogo 视为无效,避免重复;若无而 includeLogo 为真,则在合成时按默认右上位置追加。背景与前景 assetId 必须属于所选品牌套件且为图片。fill 走常规托管生成;骨架模型为 gpt-image-2 时改走托管编辑/重绘(plate 为 edit_target,可选同尺寸 mask,透明像素可编辑、不透明为保留区域),手动 mask 或 plate alpha 回退必须含透明像素。cutout 骨架要求透明隔离主体,强制 gpt-image-1,附背景 plate 作参考,请求背景透明,仅在托管失败时回退 OpenAI BYOK。
适用场景:预设开启 logo 合成;一次性请求(如“做一张带品牌 logo 的主视觉”)传 includeLogo 覆盖;对 logo 准确性敏感的客户可见场景。
限制:不适合产品上的 logo(T 恤样机、广告牌、咖啡杯等曲面/透视表面),也不适合多 logo 场景(合作 logo 墙、赞助商行),这些需准备 plate 加 mask 重绘骨架或由用户在设计工具中处理。若模型在角落画了东西,透明 logo 下会透出手绘痕迹,需重生成或裁剪。非 PNG 源会丢失透明,需重传 PNG,SVG 也可由 Sharp 栅格化。正文与标题文字同理,除非用户明确要求精确可见文字,否则应在调用方应用用 HTML/CSS 叠加。其他细节资料暂未提供。