feat: 试用过程中的细节优化

server/schemas/suite.py

@@ -77,7 +77,7 @@ class WatermarkOptions(BaseModel):
 
 
 class ProductDimensions(BaseModel):
-    """商品长宽高；尺寸图只会使用完整的三项数据。"""
+    """商品长宽高；尺寸图仅标注实际提供的方向。"""
 
     length: float | None = Field(default=None, gt=0, description="长度（按 unit 单位）")
     width: float | None = Field(default=None, gt=0, description="宽度（按 unit 单位）")
@@ -177,10 +177,15 @@ class SuiteOut(BaseModel):
 
 
 class ImageEditSingleRequest(BaseModel):
-    """POST /api/suite/image-edit：单张 AI 生图（试算页每张图的「AI 生图」入口）。"""
+    """POST /api/suite/image-edit：单张 AI 生图，可携带多张参考底图。"""
     product_id: str | None = Field(default=None, description="append=true 时回写到该商品的 generated 组")
-    image_url: str = Field(..., description="原图（stored_url 或 source_url，远程由服务端带 Referer 代下）")
+    image_url: str | None = Field(default=None, description="兼容旧客户端的单张原图 URL")
+    image_urls: list[str] = Field(default_factory=list, description="选中的参考底图 URL，可多张")
     prompt: str = Field(default="", description="用户要求（可选，作为额外生图指令）")
+    mode: Literal["edit", "outpaint"] = Field(
+        default="edit",
+        description="edit 为 AI 编辑；outpaint 只扩展到目标画布，不允许模型改动原图区域",
+    )
     model: str = Field(default="nano-banana-2")
     append: bool = Field(default=True, description="结果是否追加为商品素材（generated 组）")
     after_asset_id: str | None = Field(