扩展主站抠图请求契约

增加backgroundMode和screenColor可选字段

同步External v1 OpenAPI抠图模式说明

docs/openapi/genarrative-external-v1.openapi.json

@@ -3211,6 +3211,17 @@
             "minLength": 1,
             "description": "当前账号拥有的稳定 objectKey、项目资源 ID 或素材 ID。禁止 Data URL、Blob URL 和临时 signed URL。"
           },
+          "backgroundMode": {
+            "type": ["string", "null"],
+            "enum": ["complex", "flat", null],
+            "default": "complex",
+            "description": "抠图模式。不填按 complex 处理；flat 使用纯色背景管线。"
+          },
+          "screenColor": {
+            "type": ["string", "null"],
+            "pattern": "^(auto|#[0-9A-Fa-f]{6})$",
+            "description": "仅 flat 模式使用。可传 auto、#RRGGBB 或省略；auto 和省略由 BgFilter 自动检测背景色。complex 搭配此字段返回 400。"
+          },
           "projectId": {
             "type": ["string", "null"],
             "description": "可选项目上下文。提供 targetLayerId 时必须同时提供非空 projectId，否则在入队前返回 400。"

server-rs/crates/api-server/src/editor_project.rs

@@ -452,6 +452,8 @@ pub struct EditorImageEditRequest {
 #[serde(rename_all = "camelCase")]
 pub struct EditorBackgroundRemovalRequest {
     pub(crate) source_image_src: String,
+    pub(crate) background_mode: Option<String>,
+    pub(crate) screen_color: Option<String>,
     pub(crate) project_id: Option<String>,
     pub(crate) target_layer_id: Option<String>,
     pub(crate) asset_kind: Option<String>,

server-rs/crates/api-server/src/external_editor_api.rs

@@ -169,6 +169,8 @@ pub struct ExternalEditorProjectResourceCreateRequest {
 #[serde(rename_all = "camelCase", deny_unknown_fields)]
 pub(crate) struct ExternalEditorBackgroundRemovalRequest {
     source_image_src: String,
+    background_mode: Option<String>,
+    screen_color: Option<String>,
     project_id: Option<String>,
     target_layer_id: Option<String>,
     asset_kind: Option<String>,
@@ -183,6 +185,8 @@ impl From<ExternalEditorBackgroundRemovalRequest> for EditorBackgroundRemovalReq
     fn from(payload: ExternalEditorBackgroundRemovalRequest) -> Self {
         Self {
             source_image_src: payload.source_image_src,
+            background_mode: payload.background_mode,
+            screen_color: payload.screen_color,
             project_id: payload.project_id,
             target_layer_id: payload.target_layer_id,
             asset_kind: payload.asset_kind,