扩展主站抠图请求契约

增加backgroundMode和screenColor可选字段同步External v1 OpenAPI抠图模式说明
2026-09-16 20:02:23 +08:00
parent fa64819b6e
commit d7a0c3cffd
3 changed files with 17 additions and 0 deletions
@@ -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。"