@ohmygame/fal 0.2.0 → 0.3.0

package/.ohmygame-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "$schema": "https://www.ohmygame.ai/schema/plugin-2.json",
   "id": "ohmygame/fal",
-  "version": "0.2.0",
+  "beta": true,
+  "version": "0.3.0",
   "engines": {
-    "ohmygame-api": "^2.5.0"
+    "ohmygame-api": "^2.27.0"
   },
   "displayName": "%plugin.name%",
   "description": "%plugin.description%",
@@ -60,7 +61,11 @@
                 ],
                 "maxReferenceImages": 0
               }
-            ]
+            ],
+            "backgroundRemoval": {
+              "id": "fal-ai/birefnet",
+              "title": "BiRefNet"
+            }
           },
           "video": {
             "discoverModels": true,

package/README.md

@@ -8,12 +8,13 @@ pictures, videos, audio and 3D models. It has no chat models.
 | Kind | Model | What it takes |
 | --- | --- | --- |
 | Image | FLUX.1 [schnell] (`fal-ai/flux/schnell`) | A prompt, in 1:1, 4:3, 3:4, 16:9 or 9:16 |
+| Background removal | BiRefNet (`fal-ai/birefnet`) | One still PNG, JPEG or WebP; preserves dimensions and colors |
 | Video | Kling O3 (`fal-ai/kling-video/o3/standard/image-to-video`) | A first frame, an optional last frame, and 3, 5, 10 or 15 seconds |
 | Speech | MiniMax Speech-02 HD (`fal-ai/minimax/speech-02-hd`) | Up to 5,000 characters, in one of MiniMax's voices, as MP3 |
 | Sound effects, music | Stable Audio (`fal-ai/stable-audio`) | A description and up to 47 seconds, as WAV |
 | 3D | TRELLIS (`fal-ai/trellis`) | One picture of the object, as GLB |
 
-These are on from the start. To use more of fal.ai's models, open the fal.ai
+Generation models are on from the start. Background removal has its own processing picker and does not change the default image model. To use more of fal.ai's models, open the fal.ai
 provider in Settings → Providers and choose **Load models** under a kind: the
 plugin reads fal.ai's most used models of that kind and what each one takes
 (aspect ratios, lengths, voices, how many pictures), and you turn on the ones
@@ -27,6 +28,45 @@ fal.ai's files are on, and OhMyGame adds the key to its requests. A video,
 audio file or 3D model a restart cut off is checked again on **Retry**, not
 paid for twice. fal.ai bills each request to your account.
 
-Needs OhMyGame with plugin API 2.5.0 or later.
+Needs OhMyGame with plugin API 2.27.0 or later. Version 0.3.0 remains Beta.
 
 Published as `@ohmygame/fal` from [ohmygame-plugins](https://github.com/WhiteTowerAI/ohmygame-plugins).
+
+## Background removal
+
+On an image's canvas toolbar, choose **Image tools → Remove background**
+(中文：**图片工具 → 去除背景**), choose **BiRefNet**, then generate. Creation alone
+does not send a paid request. The existing **AI image cutout** remains a prompted
+redraw using an image generation model.
+
+The plugin uses the [official BiRefNet queue API](https://fal.ai/models/fal-ai/birefnet/api),
+General Use (Light), its default 1024×1024 operating resolution, PNG output,
+`sync_mode: false` to retain request history and `refine_foreground: false`.
+Operating resolution is internal to the model; the returned alpha must match the
+source dimensions. OhMyGame applies that alpha to the normalized source RGB and
+existing alpha, rejects resized/opaque/empty outputs and never substitutes a new
+paid request after an uncertain failure. The source is limited to a still
+PNG/JPEG/WebP up to 20 MiB and 64 million pixels; EXIF orientation and sRGB
+normalization happen before submission. Edge quality still needs inspection on
+your own artwork, especially hair, small sprites and existing transparency.
+
+Closing the app or stopping locally keeps the queued task; **Retry** resumes it.
+A failed result download or import keeps its receipt too. Do not create a second
+node to recover an uncertain submission. Inputs are sent to fal.ai using the
+existing key and approved hosts; no additional permissions or callback setup
+are needed. An output on a host outside the existing allowlist fails explicitly;
+report the hostname instead of granting a wildcard.
+
+### Local acceptance
+
+- Upgrade with the current app; confirm the existing key, provider switch,
+  image default and model visibility are retained.
+- Process a non-square JPG, a detailed PNG and a WebP; inspect foreground edges,
+  dimensions, source colors and transparent PNG export. Try an already
+  transparent source and confirm its existing alpha remains respected.
+- Stop a queued cutout, then Retry; also quit/reopen during a queued job and
+  Retry. Confirm in fal.ai request history that the same request is resumed.
+- Disconnect before downloading the result, reconnect and Retry; no second
+  submission should appear. Check explicit failure for invalid/opaque results.
+- Confirm ordinary image generation and existing video/audio/3D selections
+  still work. BiRefNet must not appear among image generation defaults.

package/locales/en.json

@@ -1,7 +1,7 @@
 {
   "plugin.name": "fal.ai",
   "plugin.description": "fal.ai's image, video, audio and 3D models, with your own API key.",
-  "plugin.longDescription": "Adds fal.ai to Settings → Providers. Enter your API key here or in Settings: FLUX.1 [schnell] makes pictures, Kling O3 makes videos of 3 to 15 seconds from a first frame (and a last one if you give it), MiniMax Speech-02 HD reads text aloud, Stable Audio makes sound effects and music, and TRELLIS makes a 3D model from a picture. fal.ai bills each request to your account. To use more of fal.ai's models, choose Load models on its page in Settings and turn on the ones you want.",
+  "plugin.longDescription": "Adds fal.ai to Settings → Providers. Enter your API key here or in Settings: FLUX.1 [schnell] makes pictures, Kling O3 makes videos of 3 to 15 seconds from a first frame (and a last one if you give it), MiniMax Speech-02 HD reads text aloud, Stable Audio makes sound effects and music, and TRELLIS makes a 3D model from a picture. fal.ai bills each request to your account. To use more of fal.ai's models, choose Load models on its page in Settings and turn on the ones you want. BiRefNet removes image backgrounds from the canvas while preserving the source dimensions and colors. This is separate from AI redraw cutout and requires OhMyGame API 2.27.",
   "config.apiKey.title": "fal.ai API key",
   "config.apiKey.description": "From fal.ai → Dashboard → Keys."
 }

package/locales/zh-CN.json

@@ -1,7 +1,7 @@
 {
   "plugin.name": "fal.ai",
   "plugin.description": "用你自己的 API key，使用 fal.ai 的图片、视频、音频和 3D 模型。",
-  "plugin.longDescription": "把 fal.ai 加入 设置 → 服务商。在这里或设置里填好 API key：FLUX.1 [schnell] 生成图片，Kling O3 根据首帧（可加尾帧）生成 3 到 15 秒的视频，MiniMax Speech-02 HD 朗读文本，Stable Audio 生成音效和音乐，TRELLIS 根据图片生成 3D 模型。每次请求由 fal.ai 向你的账户计费。想用 fal.ai 的更多模型，在设置里它的页面点「读取模型」，再勾选要用的。",
+  "plugin.longDescription": "把 fal.ai 加入 设置 → 服务商。在这里或设置里填好 API key：FLUX.1 [schnell] 生成图片，Kling O3 根据首帧（可加尾帧）生成 3 到 15 秒的视频，MiniMax Speech-02 HD 朗读文本，Stable Audio 生成音效和音乐，TRELLIS 根据图片生成 3D 模型。每次请求由 fal.ai 向你的账户计费。想用 fal.ai 的更多模型，在设置里它的页面点「读取模型」，再勾选要用的。 BiRefNet 可在画布中去除图片背景，保留原图尺寸和颜色。它与 AI 重绘抠图独立，需要 OhMyGame API 2.27。",
   "config.apiKey.title": "fal.ai API key",
   "config.apiKey.description": "在 fal.ai → Dashboard → Keys 创建。"
 }

package/media/adapter.js

@@ -499,7 +499,22 @@ async function listModels(kind, host) {
 export default {
   image: {
     models: (host) => listModels("image", host),
-    start(input, host) {
+    async start(input, host) {
+      if (input.operation === "remove-background") {
+        if (input.model !== "fal-ai/birefnet" || !input.image || typeof input.image.file !== "string")
+          return { error: "Choose BiRefNet and one source image" };
+        const result = await submit("fal-ai/birefnet", {
+          image_url: { $mediaFile: input.image.file },
+          model: "General Use (Light)",
+          operating_resolution: "1024x1024",
+          output_format: "png",
+          sync_mode: false,
+          refine_foreground: false,
+        }, host, [["image", "url"]]);
+        // Stop waiting locally while preserving queue ownership for Retry.
+        if (result.task) delete result.task.cancel;
+        return result;
+      }
       if (input.modelData) return startListed("image", input, host);
       return submit(input.model, {
         prompt: input.prompt,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ohmygame/fal",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "fal.ai's image, video, audio and 3D models, with your own API key.",
   "keywords": [
     "ohmygame-plugin",
@@ -26,7 +26,7 @@
     "pack": "ohmygame-plugin pack"
   },
   "devDependencies": {
-    "@ohmygame/plugin-cli": "^2.5.0"
+    "@ohmygame/plugin-cli": "^2.27.0"
   },
   "publishConfig": {
     "access": "public"