@howells/motif-sdk 1.1.0 → 1.3.0

package/dist/index.d.cts

@@ -171,7 +171,6 @@ interface FalPricing {
 }
 interface LeaderboardMetric {
     elo: number;
-    pricePer1k?: number | null;
     rank: number;
     winRate?: number;
 }
@@ -387,6 +386,19 @@ interface JobStatus {
     queuePosition?: number;
     status: "queued" | "processing" | "completed" | "failed";
 }
+/**
+ * A tool run accepted by the fal queue.
+ *
+ * Returned by `FalClient.submitTool`, and the handle passed back to
+ * `checkToolStatus` / `getToolResult`. The job itself carries no cost: the
+ * rate lives on the registry entry as `FalToolConfig.price`, and for a queued
+ * endpoint it is usually per-megapixel or metered, so the final cost is only
+ * known once the result is in.
+ */
+interface QueuedToolJob {
+    endpoint: string;
+    requestId: string;
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 interface FalClientConfig {
     apiKey: string;
@@ -444,6 +456,11 @@ declare function buildGenerateBody(options: GenerateOptions): {
 };
 
 interface LeaderboardEntry {
+    /**
+     * What the model's own vendor charges to run it through their API, as Artificial Analysis
+     * quoted it. Not what fal charges us - fal resells several of these for a fraction of the
+     * price. For our cost, read `falPricing` on the model in `models.ts`.
+     */
     apiPricing?: string;
     creator: string;
     elo: number;
@@ -474,6 +491,23 @@ declare const RECRAFT_STYLES: readonly ["realistic_image", "realistic_image/b_an
 /** Ideogram v3 top-level style categories. Pass as the `style` field in GenerateOptions. */
 declare const IDEOGRAM_STYLES: readonly ["AUTO", "GENERAL", "REALISTIC", "DESIGN"];
 
+/**
+ * `MotifError` and its coercion helper.
+ *
+ * Extracted from `server.ts` so `server-tools.ts` can construct errors without
+ * importing back into `server.ts` — that import was a dependency cycle. Both
+ * `server.ts` and `server-tools.ts` import from here, and `server.ts`
+ * re-exports `MotifError` so the package's public surface is unchanged.
+ */
+declare class MotifError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    /** fal's request-correlation id (from the `x-fal-request-id` header or the
+     * error body). Ties a failure back to fal's dashboard/support. */
+    readonly requestId?: string;
+    constructor(message: string, status: number, code?: string, requestId?: string);
+}
+
 /**
  * FalClient — the fal-native client.
  *
@@ -540,6 +574,24 @@ declare class FalClient {
     /** ─── Utilities ───────────────────────────────────────────── */
     /** Run a registered fal utility/tool endpoint. */
     runTool(options: ToolRunOptions): Promise<Result<ToolResponse, MotifError>>;
+    /** ─── Queue-Based Tools ───────────────────────────────────── */
+    /**
+     * Submit a tool run to the fal queue. Returns as soon as fal accepts it.
+     *
+     * The queued counterpart to `runTool`, for endpoints that outrun the
+     * synchronous request timeout. Callers choose the path — neither one falls
+     * back to the other.
+     */
+    submitTool(options: ToolRunOptions): Promise<Result<QueuedToolJob, MotifError>>;
+    /** Poll one queued tool run. */
+    checkToolStatus(job: QueuedToolJob): Promise<Result<JobStatus, MotifError>>;
+    /** Fetch the finished payload for a queued tool run. */
+    getToolResult(job: QueuedToolJob): Promise<Result<ToolResponse, MotifError>>;
+    /**
+     * Submit, poll to completion, and return the result. The convenience path
+     * for tools whose registry entry sets `queued`.
+     */
+    runToolQueued(options: ToolRunOptions, onProgress?: (status: string, queuePosition?: number) => void): Promise<Result<ToolResponse, MotifError>>;
     /**
      * Delete fal's stored IO payloads for a completed request.
      *
@@ -563,64 +615,51 @@ declare class FalClient {
     get utilityModels(): readonly ["clarity", "crystal", "rmbg", "bria"];
     /** Registered fal utility/tool endpoints. */
     get tools(): {
-        readonly birefnet: {
-            readonly category: "background";
-            readonly defaultOptions: {
-                readonly model: "General Use (Light)";
-                readonly operating_resolution: "1024x1024";
-                readonly output_format: "png";
-                readonly refine_foreground: true;
-            };
-            readonly description: "High-resolution dichotomous image segmentation and background removal.";
-            readonly endpoint: "fal-ai/birefnet/v2";
+        readonly "depth-anything": {
+            readonly category: "preprocess";
+            readonly description: "Generate Depth Anything v2 depth maps from input images.";
+            readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
             readonly inputField: "image_url";
             readonly inputKind: "image";
-            readonly name: "BirefNet Background Removal";
-            readonly outputKeys: ["image", "mask_image"];
+            readonly name: "Depth Anything v2 Preprocessor";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
-            readonly task: "image background removal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
+            readonly task: "depth preprocessing";
         };
-        readonly "bria-rmbg": {
-            readonly category: "background";
-            readonly description: "Commercial-safe background removal for images.";
-            readonly endpoint: "fal-ai/bria/background/remove";
+        readonly dwpose: {
+            readonly category: "preprocess";
+            readonly description: "Extract body, hand, and face pose skeletons from an image.";
+            readonly endpoint: "fal-ai/dwpose";
             readonly inputField: "image_url";
             readonly inputKind: "image";
-            readonly name: "Bria RMBG 2.0";
+            readonly name: "DWPose Estimation";
             readonly outputKeys: ["image"];
-            readonly pricing: "$0.02/image";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
-            readonly task: "image background removal";
-        };
-        readonly "bria-video-rmbg": {
-            readonly category: "background";
-            readonly defaultOptions: {
-                readonly background_color: "Black";
-                readonly output_container_and_codec: "webm_vp9";
-                readonly preserve_audio: true;
+            readonly price: {
+                readonly kind: "second";
+                readonly usd: 0.0006;
             };
-            readonly description: "Remove video backgrounds with configurable output container.";
-            readonly endpoint: "bria/video/background-removal";
-            readonly inputField: "video_url";
-            readonly inputKind: "video";
-            readonly name: "Bria Video Background Removal";
-            readonly outputKeys: ["video"];
-            readonly pricing: "$0.14/sec";
-            readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
-            readonly task: "video background removal";
+            readonly pricing: "$0.0006/compute-second";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/dwpose";
+            readonly task: "pose preprocessing";
         };
-        readonly "depth-anything": {
+        readonly hed: {
             readonly category: "preprocess";
-            readonly description: "Generate Depth Anything v2 depth maps from input images.";
-            readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
+            readonly description: "Generate HED soft edge maps for ControlNet-style workflows.";
+            readonly endpoint: "fal-ai/image-preprocessors/hed";
             readonly inputField: "image_url";
             readonly inputKind: "image";
-            readonly name: "Depth Anything v2 Preprocessor";
+            readonly name: "HED Edge Preprocessor";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
-            readonly task: "depth preprocessing";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed";
+            readonly task: "edge preprocessing";
         };
         readonly lineart: {
             readonly category: "preprocess";
@@ -633,6 +672,9 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "Line Art Preprocessor";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
             readonly task: "image preprocessing";
@@ -649,6 +691,9 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "Marigold Depth Estimation";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
             readonly task: "depth map";
@@ -665,6 +710,9 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "MiDaS Depth Estimation";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
             readonly task: "depth map";
@@ -677,36 +725,42 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "MiDaS Preprocessor";
             readonly outputKeys: ["depth_map", "normal_map"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas";
             readonly task: "depth and normal preprocessing";
         };
-        readonly nsfw: {
-            readonly category: "moderation";
-            readonly description: "Predict whether one or more images contain NSFW concepts.";
-            readonly endpoint: "fal-ai/x-ailab/nsfw";
-            readonly inputField: "image_urls";
-            readonly inputKind: "images";
-            readonly name: "NSFW Checker";
-            readonly outputKeys: ["has_nsfw_concepts"];
-            readonly pricing: "$0.001/image";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-            readonly task: "vision moderation";
-        };
-        readonly rembg: {
-            readonly category: "background";
-            readonly defaultOptions: {
-                readonly crop_to_bbox: false;
+        readonly mlsd: {
+            readonly category: "preprocess";
+            readonly description: "Detect straight line segments for architectural and interior control maps.";
+            readonly endpoint: "fal-ai/image-preprocessors/mlsd";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "M-LSD Line Preprocessor";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
             };
-            readonly description: "Generic image background removal utility.";
-            readonly endpoint: "fal-ai/imageutils/rembg";
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd";
+            readonly task: "line segment preprocessing";
+        };
+        readonly pidi: {
+            readonly category: "preprocess";
+            readonly description: "Generate PiDiNet soft edge maps from an input image.";
+            readonly endpoint: "fal-ai/image-preprocessors/pidi";
             readonly inputField: "image_url";
             readonly inputKind: "image";
-            readonly name: "Remove Background";
+            readonly name: "PiDiNet Edge Preprocessor";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-            readonly task: "image background removal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi";
+            readonly task: "edge preprocessing";
         };
         readonly "sam-preprocessor": {
             readonly category: "preprocess";
@@ -716,6 +770,9 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "SAM Preprocessor";
             readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
             readonly task: "segmentation preprocessing";
@@ -735,7 +792,11 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "SAM 2 Auto Segment";
             readonly outputKeys: ["combined_mask", "individual_masks"];
+            readonly price: {
+                readonly kind: "metered";
+            };
             readonly pricing: "$0/compute-second listed by fal";
+            readonly queued: true;
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
             readonly task: "automatic image segmentation";
         };
@@ -752,7 +813,11 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "SAM 3.1 Image";
             readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-            readonly pricing: "$0.005/request";
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.01;
+            };
+            readonly pricing: "$0.01/request";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
             readonly task: "promptable image segmentation";
         };
@@ -768,54 +833,14 @@ declare class FalClient {
             readonly inputKind: "video";
             readonly name: "SAM 3.1 Video";
             readonly outputKeys: ["video", "boundingbox_frames_zip"];
-            readonly pricing: "fal pricing varies by frame count";
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.01/16 frames of video input";
+            readonly queued: true;
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
             readonly task: "multi-object video segmentation";
         };
-        readonly "sam3-3d-align": {
-            readonly category: "3d";
-            readonly description: "Align SAM 3D objects and bodies into a shared scene.";
-            readonly endpoint: "fal-ai/sam-3/3d-align";
-            readonly inputField: "image_url";
-            readonly inputKind: "image";
-            readonly name: "SAM 3D Align";
-            readonly outputKeys: ["scene_glb", "metadata", "artifacts_zip"];
-            readonly pricing: "fal pricing varies by scene";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align";
-            readonly task: "3D scene alignment";
-        };
-        readonly "sam3-3d-body": {
-            readonly category: "3d";
-            readonly defaultOptions: {
-                readonly export_meshes: true;
-                readonly include_3d_keypoints: true;
-                readonly include_mhr_params: true;
-            };
-            readonly description: "Reconstruct human body meshes and keypoints from a single image.";
-            readonly endpoint: "fal-ai/sam-3/3d-body";
-            readonly inputField: "image_url";
-            readonly inputKind: "image";
-            readonly name: "SAM 3D Body";
-            readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
-            readonly pricing: "$0.015/inference";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body";
-            readonly task: "single-image 3D body reconstruction";
-        };
-        readonly "sam3-3d-objects": {
-            readonly category: "3d";
-            readonly defaultOptions: {
-                readonly prompt: "car";
-            };
-            readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
-            readonly endpoint: "fal-ai/sam-3/3d-objects";
-            readonly inputField: "image_url";
-            readonly inputKind: "image";
-            readonly name: "SAM 3D Objects";
-            readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
-            readonly pricing: "$0.02/generation";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
-            readonly task: "single-image 3D object reconstruction";
-        };
         readonly "sam3-image": {
             readonly category: "segmentation";
             readonly defaultOptions: {
@@ -829,6 +854,10 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "SAM 3 Image";
             readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.005;
+            };
             readonly pricing: "$0.005/request";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
             readonly task: "promptable image segmentation";
@@ -844,7 +873,11 @@ declare class FalClient {
             readonly inputField: "image_url";
             readonly inputKind: "image";
             readonly name: "SAM 3 Image RLE";
-            readonly outputKeys: ["rle_masks", "metadata", "scores", "boxes"];
+            readonly outputKeys: ["rle", "scores", "boxes", "metadata"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.005;
+            };
             readonly pricing: "$0.005/request";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle";
             readonly task: "promptable image segmentation to RLE";
@@ -863,7 +896,11 @@ declare class FalClient {
             readonly inputKind: "video";
             readonly name: "SAM 3 Video";
             readonly outputKeys: ["video", "boundingbox_frames_zip"];
-            readonly pricing: "$0.005/16 frames";
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.005/16 frames of video input";
+            readonly queued: true;
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
             readonly task: "promptable video segmentation";
         };
@@ -879,104 +916,1680 @@ declare class FalClient {
             readonly inputField: "video_url";
             readonly inputKind: "video";
             readonly name: "SAM 3 Video RLE";
-            readonly outputKeys: ["rle_masks", "metadata"];
-            readonly pricing: "$0.005/16 frames";
+            readonly outputKeys: ["video", "boundingbox_frames_zip"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.005/16 frames of video";
+            readonly queued: true;
             readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
             readonly task: "promptable video segmentation to RLE";
         };
-        readonly "topaz-image": {
-            readonly category: "upscale";
-            readonly defaultOptions: {
-                readonly model: "Standard V2";
-                readonly output_format: "jpeg";
-                readonly upscale_factor: 2;
+        readonly scribble: {
+            readonly category: "preprocess";
+            readonly description: "Turn an image into a scribble-style control map.";
+            readonly endpoint: "fal-ai/image-preprocessors/scribble";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Scribble Preprocessor";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
             };
-            readonly description: "Professional Topaz image enhancement and upscaling.";
-            readonly endpoint: "fal-ai/topaz/upscale/image";
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble";
+            readonly task: "scribble preprocessing";
+        };
+        readonly teed: {
+            readonly category: "preprocess";
+            readonly description: "Generate TEED edge maps from an input image.";
+            readonly endpoint: "fal-ai/image-preprocessors/teed";
             readonly inputField: "image_url";
             readonly inputKind: "image";
-            readonly name: "Topaz Image Upscale";
+            readonly name: "TEED Edge Preprocessor";
             readonly outputKeys: ["image"];
-            readonly pricing: "$0.08+ by output megapixels";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-            readonly task: "image enhancement";
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed";
+            readonly task: "edge preprocessing";
         };
-        readonly "topaz-video": {
-            readonly category: "upscale";
-            readonly defaultOptions: {
-                readonly model: "Proteus";
-                readonly upscale_factor: 2;
+        readonly "zoe-depth": {
+            readonly category: "preprocess";
+            readonly description: "Generate ZoeDepth metric depth maps from an input image.";
+            readonly endpoint: "fal-ai/image-preprocessors/zoe";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "ZoeDepth Preprocessor";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
             };
-            readonly description: "Professional Topaz video enhancement and upscaling.";
-            readonly endpoint: "fal-ai/topaz/upscale/video";
-            readonly inputField: "video_url";
-            readonly inputKind: "video";
-            readonly name: "Topaz Video Upscale";
-            readonly outputKeys: ["video"];
-            readonly pricing: "$0.01-$0.08/sec by output resolution";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-            readonly task: "video enhancement";
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
+            readonly task: "depth preprocessing";
         };
-    };
-    /** ─── Private ─────────────────────────────────────────────── */
-    /** Authenticated fetch to fal.ai APIs with retry logic. */
-    private request;
-    private ephemeralHeaders;
-    /**
-     * Normalize fal.ai responses.
-     * Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
-     */
-    private normalizeResponse;
-}
-declare class MotifError extends Error {
-    readonly status: number;
-    readonly code?: string;
-    /** fal's request-correlation id (from the `x-fal-request-id` header or the
-     * error body). Ties a failure back to fal's dashboard/support. */
-    readonly requestId?: string;
-    constructor(message: string, status: number, code?: string, requestId?: string);
-}
-
-type FalToolInputKind = "image" | "images" | "video";
-interface FalToolConfig {
-    category: "3d" | "background" | "depth" | "moderation" | "preprocess" | "segmentation" | "upscale";
-    defaultOptions?: Record<string, unknown>;
-    description: string;
-    endpoint: string;
-    inputField: "image_url" | "image_urls" | "video_url";
-    inputKind: FalToolInputKind;
-    name: string;
-    outputKeys: string[];
-    pricing: string;
-    sourceUrl: string;
-    task: string;
-}
-interface FalToolRunOptions {
-    input?: string;
-    inputs?: string[];
-    options?: Record<string, unknown>;
-    tool: string;
-}
-interface FalToolRequest {
-    body: Record<string, unknown>;
-    endpoint: string;
-    tool: FalToolConfig;
-}
-declare const FAL_TOOLS: {
-    readonly birefnet: {
-        readonly category: "background";
-        readonly defaultOptions: {
-            readonly model: "General Use (Light)";
-            readonly operating_resolution: "1024x1024";
-            readonly output_format: "png";
-            readonly refine_foreground: true;
+        readonly "bria-eraser": {
+            readonly category: "erase";
+            readonly description: "Commercial-safe removal of a masked region, inpainted from surrounding context.";
+            readonly endpoint: "fal-ai/bria/eraser";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Bria Eraser";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.04;
+            };
+            readonly pricing: "$0.04/generation";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/eraser";
+            readonly task: "masked object erasure";
         };
-        readonly description: "High-resolution dichotomous image segmentation and background removal.";
+        readonly "bria-expand": {
+            readonly category: "reframe";
+            readonly description: "Expand an image onto a larger canvas, generating the new border area.";
+            readonly endpoint: "fal-ai/bria/expand";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Bria Image Expansion";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.04;
+            };
+            readonly pricing: "$0.04/generation";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/expand";
+            readonly task: "image outpainting";
+        };
+        readonly "bria-genfill": {
+            readonly category: "erase";
+            readonly description: "Generative fill of a masked region from a prompt, commercial-safe.";
+            readonly endpoint: "fal-ai/bria/genfill";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Bria GenFill";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.04;
+            };
+            readonly pricing: "$0.04/generation";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/genfill";
+            readonly task: "masked generative fill";
+        };
+        readonly "finegrain-eraser": {
+            readonly category: "erase";
+            readonly description: "Remove a prompted object and its shadows and reflections, filling the gap.";
+            readonly endpoint: "fal-ai/finegrain-eraser";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Finegrain Object Eraser";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.27;
+            };
+            readonly pricing: "$0.27/image at the default standard mode; $0.18 express, $0.36 premium";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/finegrain-eraser";
+            readonly task: "prompted object erasure";
+        };
+        readonly "flux-outpaint": {
+            readonly category: "reframe";
+            readonly description: "Outpaint an image by a per-edge pixel expansion with FLUX.2 pro.";
+            readonly endpoint: "fal-ai/flux-2-pro/outpaint";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "FLUX.2 Pro Outpaint";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.03 for the first output megapixel, then $0.015 per extra megapixel of input and output, rounded up";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/flux-2-pro/outpaint";
+            readonly task: "image outpainting";
+        };
+        readonly "iclight-v2": {
+            readonly category: "relight";
+            readonly description: "Relight a subject from a prompt, harmonising it with a new light direction.";
+            readonly endpoint: "fal-ai/iclight-v2";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "IC-Light v2";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.1;
+            };
+            readonly pricing: "$0.10/megapixel";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/iclight-v2";
+            readonly task: "prompted relighting";
+        };
+        readonly "ideogram-reframe": {
+            readonly category: "reframe";
+            readonly description: "Reframe an image to a new aspect ratio, generating the fill.";
+            readonly endpoint: "fal-ai/ideogram/v3/reframe";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Ideogram v3 Reframe";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.06;
+            };
+            readonly pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/reframe";
+            readonly task: "aspect ratio reframing";
+        };
+        readonly "lighting-restoration": {
+            readonly category: "relight";
+            readonly description: "Restore natural, even lighting across one or more input images.";
+            readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
+            readonly inputField: "image_urls";
+            readonly inputKind: "images";
+            readonly name: "Qwen Lighting Restoration";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.035;
+            };
+            readonly pricing: "$0.035/megapixel";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
+            readonly task: "lighting restoration";
+        };
+        readonly "object-removal": {
+            readonly category: "erase";
+            readonly description: "Remove a prompted object from an image and fill the gap.";
+            readonly endpoint: "fal-ai/object-removal";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Object Removal";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.024;
+            };
+            readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal";
+            readonly task: "prompted object removal";
+        };
+        readonly "object-removal-bbox": {
+            readonly category: "erase";
+            readonly description: "Remove whatever falls inside supplied bounding boxes.";
+            readonly endpoint: "fal-ai/object-removal/bbox";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Object Removal by Box";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.024;
+            };
+            readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox";
+            readonly task: "bounding box object removal";
+        };
+        readonly "object-removal-mask": {
+            readonly category: "erase";
+            readonly description: "Remove the masked region of an image and fill the gap.";
+            readonly endpoint: "fal-ai/object-removal/mask";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Object Removal by Mask";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.024;
+            };
+            readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask";
+            readonly task: "masked object removal";
+        };
+        readonly "remove-lighting": {
+            readonly category: "relight";
+            readonly description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.";
+            readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
+            readonly inputField: "image_urls";
+            readonly inputKind: "images";
+            readonly name: "Qwen Remove Lighting";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.035;
+            };
+            readonly pricing: "$0.035/megapixel";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
+            readonly task: "lighting removal";
+        };
+        readonly "smart-resize": {
+            readonly category: "reframe";
+            readonly description: "Resize one image to several target sizes, recomposing rather than cropping.";
+            readonly endpoint: "fal-ai/smart-resize";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Smart Resize";
+            readonly outputKeys: ["images", "results"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/smart-resize";
+            readonly task: "multi-size recomposition";
+        };
+        readonly "text-removal": {
+            readonly category: "erase";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Remove all rendered text from an image, rebuilding what sat behind it.";
+            readonly endpoint: "fal-ai/image-editing/text-removal";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Text Removal";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.04;
+            };
+            readonly pricing: "$0.04/image";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal";
+            readonly task: "text removal";
+        };
+        readonly "ben-v2": {
+            readonly category: "background";
+            readonly description: "Fast, high-quality background removal for images.";
+            readonly endpoint: "fal-ai/ben/v2/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "BEN v2 Background Removal";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.025;
+            };
+            readonly pricing: "$0.025/megapixel";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image";
+            readonly task: "image background removal";
+        };
+        readonly birefnet: {
+            readonly category: "background";
+            readonly defaultOptions: {
+                readonly model: "General Use (Light)";
+                readonly operating_resolution: "1024x1024";
+                readonly output_format: "png";
+                readonly refine_foreground: true;
+            };
+            readonly description: "High-resolution dichotomous image segmentation and background removal.";
+            readonly endpoint: "fal-ai/birefnet/v2";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "BirefNet Background Removal";
+            readonly outputKeys: ["image", "mask_image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
+            readonly task: "image background removal";
+        };
+        readonly "bria-rmbg": {
+            readonly category: "background";
+            readonly description: "Commercial-safe background removal for images.";
+            readonly endpoint: "fal-ai/bria/background/remove";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Bria RMBG 2.0";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.018;
+            };
+            readonly pricing: "$0.018/generation";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
+            readonly task: "image background removal";
+        };
+        readonly "bria-video-rmbg": {
+            readonly category: "background";
+            readonly defaultOptions: {
+                readonly background_color: "Black";
+                readonly output_container_and_codec: "webm_vp9";
+                readonly preserve_audio: true;
+            };
+            readonly description: "Remove video backgrounds with configurable output container.";
+            readonly endpoint: "bria/video/background-removal";
+            readonly inputField: "video_url";
+            readonly inputKind: "video";
+            readonly name: "Bria Video Background Removal";
+            readonly outputKeys: ["video"];
+            readonly price: {
+                readonly kind: "second";
+                readonly usd: 0.00425;
+            };
+            readonly pricing: "$0.00425/sec";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
+            readonly task: "video background removal";
+        };
+        readonly ddcolor: {
+            readonly category: "restoration";
+            readonly description: "Colourise black-and-white photographs.";
+            readonly endpoint: "fal-ai/ddcolor";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "DDColor Colourisation";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.001;
+            };
+            readonly pricing: "$0.001/megapixel";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/ddcolor";
+            readonly task: "photo colourisation";
+        };
+        readonly rembg: {
+            readonly category: "background";
+            readonly defaultOptions: {
+                readonly crop_to_bbox: false;
+            };
+            readonly description: "Generic image background removal utility.";
+            readonly endpoint: "fal-ai/imageutils/rembg";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Remove Background";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
+            readonly task: "image background removal";
+        };
+        readonly "seedvr-upscale": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Diffusion image restoration and upscaling with SeedVR.";
+            readonly endpoint: "fal-ai/seedvr/upscale/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "SeedVR Image Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.001;
+            };
+            readonly pricing: "$0.001/megapixel";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image";
+            readonly task: "image restoration and upscaling";
+        };
+        readonly "topaz-adjust": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz exposure, white balance, and colour adjustment.";
+            readonly endpoint: "topaz/adjust/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Adjust";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 per 24 output megapixels";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/adjust/image";
+            readonly task: "tonal adjustment";
+        };
+        readonly "topaz-creative": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz Bloom upscaling, which reimagines detail rather than preserving it.";
+            readonly endpoint: "topaz/upscale/image/creative";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Creative Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.96 per 24 output megapixels";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative";
+            readonly task: "creative image upscaling";
+        };
+        readonly "topaz-denoise": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz noise reduction at source resolution.";
+            readonly endpoint: "topaz/denoise/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Denoise";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/denoise/image";
+            readonly task: "image denoising";
+        };
+        readonly "topaz-generative": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz Wonder upscaling, which synthesises plausible detail as it enlarges.";
+            readonly endpoint: "topaz/upscale/image/generative";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Generative Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative";
+            readonly task: "generative image upscaling";
+        };
+        readonly "topaz-image": {
+            readonly category: "upscale";
+            readonly defaultOptions: {
+                readonly model: "Standard V2";
+                readonly output_format: "jpeg";
+                readonly upscale_factor: 2;
+            };
+            readonly description: "Professional Topaz image enhancement and upscaling.";
+            readonly endpoint: "fal-ai/topaz/upscale/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Image Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
+            readonly task: "image enhancement";
+        };
+        readonly "topaz-precision": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz upscaling that preserves the original detail rather than inventing it.";
+            readonly endpoint: "topaz/upscale/image/precision";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Precision Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 per 24 output megapixels, any precision model";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/precision";
+            readonly task: "faithful image upscaling";
+        };
+        readonly "topaz-restore": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz restoration of damaged or degraded photographs at source resolution.";
+            readonly endpoint: "topaz/restore/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Restore";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/restore/image";
+            readonly task: "photo restoration";
+        };
+        readonly "topaz-sharpen": {
+            readonly category: "restoration";
+            readonly defaultOptions: {
+                readonly output_format: "png";
+            };
+            readonly description: "Topaz deblurring and sharpening at source resolution.";
+            readonly endpoint: "topaz/sharpen/image";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Sharpen";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/sharpen/image";
+            readonly task: "image sharpening";
+        };
+        readonly "topaz-transparent": {
+            readonly category: "restoration";
+            readonly description: "Topaz upscaling that preserves the alpha channel end to end.";
+            readonly endpoint: "topaz/upscale/image/transparent";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Topaz Transparent Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: number;
+            };
+            readonly pricing: "$0.08 per 24 output megapixels";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/transparent";
+            readonly task: "transparent image upscaling";
+        };
+        readonly "topaz-video": {
+            readonly category: "upscale";
+            readonly defaultOptions: {
+                readonly model: "Proteus";
+                readonly upscale_factor: 2;
+            };
+            readonly description: "Professional Topaz video enhancement and upscaling.";
+            readonly endpoint: "fal-ai/topaz/upscale/video";
+            readonly inputField: "video_url";
+            readonly inputKind: "video";
+            readonly name: "Topaz Video Upscale";
+            readonly outputKeys: ["video"];
+            readonly price: {
+                readonly kind: "second";
+                readonly usd: 0.01;
+            };
+            readonly pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
+            readonly task: "video enhancement";
+        };
+        readonly "hunyuan3d-v3": {
+            readonly category: "3d";
+            readonly description: "Reconstruct a textured 3D mesh from a single image, with optional multi-view inputs.";
+            readonly endpoint: "fal-ai/hunyuan3d-v3/image-to-3d";
+            readonly inputField: "input_image_url";
+            readonly inputKind: "image";
+            readonly name: "Hunyuan3D v3 Image to 3D";
+            readonly outputKeys: ["model_glb", "model_urls", "thumbnail"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.375;
+            };
+            readonly pricing: "$0.375/generation at the default Normal type; $0.45 low poly, $0.225 geometry only, and $0.15 each for PBR, multi-view, or a custom face count";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/hunyuan3d-v3/image-to-3d";
+            readonly task: "single-image 3D reconstruction";
+        };
+        readonly "ideogram-layerize-text": {
+            readonly category: "layers";
+            readonly description: "Split an image into background image layers plus editable HTML text containers.";
+            readonly endpoint: "fal-ai/ideogram/v3/layerize-text";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Ideogram v3 Text Layerize";
+            readonly outputKeys: ["image_layers", "image", "text_html", "text_containers"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.09;
+            };
+            readonly pricing: "$0.09/image";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/layerize-text";
+            readonly task: "text and image layer extraction";
+        };
+        readonly "ideogram-tiling": {
+            readonly category: "material";
+            readonly description: "Generate a seamlessly tiling texture, optionally conditioned on a source image.";
+            readonly endpoint: "ideogram/v4/tiling";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Ideogram v4 Tiling";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.06;
+            };
+            readonly pricing: "$0.06/megapixel at the default BALANCED speed; $0.03 turbo, $0.10 quality";
+            readonly sourceUrl: "https://fal.ai/models/ideogram/v4/tiling";
+            readonly task: "seamless texture generation";
+        };
+        readonly image2svg: {
+            readonly category: "vector";
+            readonly description: "Trace a raster image into layered SVG paths.";
+            readonly endpoint: "fal-ai/image2svg";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Image to SVG";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.005;
+            };
+            readonly pricing: "$0.005/image";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image2svg";
+            readonly task: "raster to vector tracing";
+        };
+        readonly patina: {
+            readonly category: "material";
+            readonly description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.";
+            readonly endpoint: "fal-ai/patina";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Patina PBR Maps";
+            readonly outputKeys: ["images"];
+            readonly outputLabels: {
+                readonly images: {
+                    readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
+                    readonly fromOption: "maps";
+                };
+            };
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.01 base plus $0.01/megapixel per output map, so all 5 maps on a 1MP image cost $0.06; the listed rate is per map";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/patina";
+            readonly task: "PBR material decomposition";
+        };
+        readonly "patina-extract": {
+            readonly category: "material";
+            readonly description: "Extract a tiling PBR material from a prompted region of a photograph.";
+            readonly endpoint: "fal-ai/patina/material/extract";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Patina Material Extract";
+            readonly outputKeys: ["images"];
+            readonly outputLabels: {
+                readonly images: {
+                    readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
+                    readonly fromOption: "maps";
+                };
+            };
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.10 base only; add $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract";
+            readonly task: "tiling material extraction";
+        };
+        readonly "qwen-layered": {
+            readonly category: "layers";
+            readonly description: "Split an image into a configurable number of stacked RGBA layers.";
+            readonly endpoint: "fal-ai/qwen-image-layered";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Qwen Image Layered";
+            readonly outputKeys: ["images"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.05 per image; fal does not say whether that counts the input image or each of the generated layers, so no estimate is reported";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered";
+            readonly task: "image layer decomposition";
+        };
+        readonly "recraft-vectorize": {
+            readonly category: "vector";
+            readonly description: "Convert a raster image into a clean SVG.";
+            readonly endpoint: "fal-ai/recraft/vectorize";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Recraft Vectorize";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.04;
+            };
+            readonly pricing: "$0.04/image, $0.08 with a vector style";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/recraft/vectorize";
+            readonly task: "raster to vector conversion";
+        };
+        readonly "sam3-3d-align": {
+            readonly category: "3d";
+            readonly description: "Align SAM 3D objects and bodies into a shared scene.";
+            readonly endpoint: "fal-ai/sam-3/3d-align";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "SAM 3D Align";
+            readonly outputKeys: ["scene_glb", "model_glb", "visualization", "body_mesh_ply", "metadata"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align";
+            readonly task: "3D scene alignment";
+        };
+        readonly "sam3-3d-body": {
+            readonly category: "3d";
+            readonly defaultOptions: {
+                readonly export_meshes: true;
+                readonly include_3d_keypoints: true;
+                readonly include_mhr_params: true;
+            };
+            readonly description: "Reconstruct human body meshes and keypoints from a single image.";
+            readonly endpoint: "fal-ai/sam-3/3d-body";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "SAM 3D Body";
+            readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body";
+            readonly task: "single-image 3D body reconstruction";
+        };
+        readonly "sam3-3d-objects": {
+            readonly category: "3d";
+            readonly defaultOptions: {
+                readonly prompt: "car";
+            };
+            readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
+            readonly endpoint: "fal-ai/sam-3/3d-objects";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "SAM 3D Objects";
+            readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.02 per unit; fal does not define a unit, and this endpoint returns one mesh per detected object, so no estimate is reported";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
+            readonly task: "single-image 3D object reconstruction";
+        };
+        readonly "seedream-layerize": {
+            readonly category: "layers";
+            readonly description: "Split an image into editable Seedream layers plus flattened previews.";
+            readonly endpoint: "bytedance/seedream/v5/pro/layerize";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Seedream v5 Pro Layerize";
+            readonly outputKeys: ["layers", "images"];
+            readonly outputLabels: {
+                readonly layers: {
+                    readonly fromItem: {
+                        readonly nameField: "name";
+                        readonly orderField: "z_index";
+                    };
+                };
+            };
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize";
+            readonly task: "image layer decomposition";
+        };
+        readonly "seedvr-seamless": {
+            readonly category: "material";
+            readonly description: "Upscale a tiling texture while keeping its edges seamless. ";
+            readonly endpoint: "fal-ai/seedvr/upscale/image/seamless";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "SeedVR Seamless Upscale";
+            readonly outputKeys: ["image"];
+            readonly price: {
+                readonly kind: "megapixel";
+                readonly usd: 0.0025;
+            };
+            readonly pricing: "$0.0025/megapixel";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless";
+            readonly task: "seamless texture upscaling";
+        };
+        readonly "trellis-2": {
+            readonly category: "3d";
+            readonly description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.";
+            readonly endpoint: "fal-ai/trellis-2";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "TRELLIS 2";
+            readonly outputKeys: ["model_glb"];
+            readonly price: {
+                readonly kind: "call";
+                readonly usd: 0.3;
+            };
+            readonly pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/trellis-2";
+            readonly task: "single-image 3D reconstruction";
+        };
+        readonly "got-ocr": {
+            readonly category: "analysis";
+            readonly description: "Transcribe text from one or more images, optionally as formatted multi-page output.";
+            readonly endpoint: "fal-ai/got-ocr/v2";
+            readonly inputField: "input_image_urls";
+            readonly inputKind: "images";
+            readonly name: "GOT-OCR 2.0";
+            readonly outputKeys: ["outputs"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.05/image";
+            readonly queued: true;
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2";
+            readonly task: "optical character recognition";
+        };
+        readonly "moondream-caption": {
+            readonly category: "analysis";
+            readonly description: "Write a short, normal, or long caption for an image.";
+            readonly endpoint: "fal-ai/moondream3-preview/caption";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Moondream 3 Caption";
+            readonly outputKeys: ["output"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption";
+            readonly task: "image captioning";
+        };
+        readonly "moondream-detect": {
+            readonly category: "analysis";
+            readonly description: "Detect prompted objects and return their bounding boxes, with an optional preview.";
+            readonly endpoint: "fal-ai/moondream3-preview/detect";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Moondream 3 Detect";
+            readonly outputKeys: ["objects", "image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect";
+            readonly task: "object detection";
+        };
+        readonly "moondream-point": {
+            readonly category: "analysis";
+            readonly description: "Return point coordinates for every instance of a prompted subject.";
+            readonly endpoint: "fal-ai/moondream3-preview/point";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Moondream 3 Point";
+            readonly outputKeys: ["points", "image"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point";
+            readonly task: "object pointing";
+        };
+        readonly "moondream-query": {
+            readonly category: "analysis";
+            readonly description: "Answer a free-form question about an image, with reasoning.";
+            readonly endpoint: "fal-ai/moondream3-preview/query";
+            readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Moondream 3 Query";
+            readonly outputKeys: ["output", "reasoning"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/query";
+            readonly task: "visual question answering";
+        };
+        readonly nsfw: {
+            readonly category: "moderation";
+            readonly description: "Predict whether one or more images contain NSFW concepts.";
+            readonly endpoint: "fal-ai/x-ailab/nsfw";
+            readonly inputField: "image_urls";
+            readonly inputKind: "images";
+            readonly name: "NSFW Checker";
+            readonly outputKeys: ["has_nsfw_concepts"];
+            readonly price: {
+                readonly kind: "metered";
+            };
+            readonly pricing: "$0.001/image";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
+            readonly task: "vision moderation";
+        };
+    };
+    /**
+     * The seam `server-tools.ts` runs against — the client's authenticated fetch
+     * and its queue status parser, exposed without widening the public surface.
+     */
+    private get toolExecutor();
+    /** ─── Private ─────────────────────────────────────────────── */
+    /** Authenticated fetch to fal.ai APIs with retry logic. */
+    private request;
+    private ephemeralHeaders;
+    /**
+     * Normalize fal.ai responses.
+     * Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
+     */
+    private normalizeResponse;
+}
+
+type FalToolInputKind = "image" | "images" | "video";
+/**
+ * Machine-readable cost, so `--dry-run` can emit a number rather than the
+ * prose in `pricing`. Required on every entry: a missing price is what makes
+ * an agent unable to budget across a registry spanning $0.001 to $0.48.
+ */
+type FalToolPrice = {
+    kind: "call";
+    usd: number;
+} | {
+    kind: "megapixel";
+    usd: number;
+} | {
+    kind: "second";
+    usd: number;
+} | {
+    kind: "metered";
+};
+interface FalToolConfig {
+    category: "3d" | "analysis" | "background" | "depth" | "erase" | "layers" | "material" | "moderation" | "preprocess" | "reframe" | "relight" | "restoration" | "segmentation" | "upscale" | "vector";
+    defaultOptions?: Record<string, unknown>;
+    description: string;
+    endpoint: string;
+    inputField: "image_url" | "image_urls" | "input_image_url" | "input_image_urls" | "video_url";
+    inputKind: FalToolInputKind;
+    name: string;
+    outputKeys: string[];
+    /**
+     * Names for the positions of an array-valued output. Used to name downloaded
+     * files: without it a PBR set lands as images-2.png, images-3.png and the
+     * caller cannot tell a roughness map from a normal map.
+     *
+     * Two rule shapes, because the names come from two different places.
+     *
+     * Request-driven: `fromOption` names the request option that actually
+     * determines the order — read the resolved request body first and use its
+     * value when present, since a caller may reorder or subset it. `fallback` is
+     * the endpoint's schema default, used when the option is absent.
+     *
+     * Response-driven: `fromItem` reads the name off each element of the output
+     * array itself, for endpoints that label what they produced (seedream's
+     * layer stack names every layer). `nameField` holds the name and
+     * `orderField`, when set, holds a non-negative integer that prefixes it so
+     * the files sort in stack order. These strings come from a model, so the
+     * consumer slugifies them into a filename and keeps positional naming when
+     * nothing usable survives.
+     *
+     * Whichever is used, check the label count against the URL count before
+     * applying it: a mislabelled map is worse than a positional one, because it
+     * reads as authoritative.
+     *
+     * Only set this where the order or the naming is actually determined — by a
+     * request option, by the schema, or by the response. Leave genuinely
+     * unordered, unnamed arrays unlabelled.
+     */
+    outputLabels?: Record<string, {
+        fallback: readonly string[];
+        fromOption?: string;
+    } | {
+        fromItem: {
+            nameField: string;
+            orderField?: string;
+        };
+    }>;
+    price: FalToolPrice;
+    pricing: string;
+    /**
+     * Endpoint routinely exceeds the 120s sync timeout; callers should use the
+     * queue path.
+     */
+    queued?: true;
+    sourceUrl: string;
+    task: string;
+}
+interface FalToolRunOptions {
+    input?: string;
+    inputs?: string[];
+    options?: Record<string, unknown>;
+    tool: string;
+}
+interface FalToolRequest {
+    body: Record<string, unknown>;
+    endpoint: string;
+    tool: FalToolConfig;
+}
+
+declare const FAL_TOOLS: {
+    readonly "depth-anything": {
+        readonly category: "preprocess";
+        readonly description: "Generate Depth Anything v2 depth maps from input images.";
+        readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Depth Anything v2 Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
+        readonly task: "depth preprocessing";
+    };
+    readonly dwpose: {
+        readonly category: "preprocess";
+        readonly description: "Extract body, hand, and face pose skeletons from an image.";
+        readonly endpoint: "fal-ai/dwpose";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "DWPose Estimation";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "second";
+            readonly usd: 0.0006;
+        };
+        readonly pricing: "$0.0006/compute-second";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/dwpose";
+        readonly task: "pose preprocessing";
+    };
+    readonly hed: {
+        readonly category: "preprocess";
+        readonly description: "Generate HED soft edge maps for ControlNet-style workflows.";
+        readonly endpoint: "fal-ai/image-preprocessors/hed";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "HED Edge Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed";
+        readonly task: "edge preprocessing";
+    };
+    readonly lineart: {
+        readonly category: "preprocess";
+        readonly defaultOptions: {
+            readonly coarse: false;
+        };
+        readonly description: "Generate line art/control-style edges from an input image.";
+        readonly endpoint: "fal-ai/image-preprocessors/lineart";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Line Art Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
+        readonly task: "image preprocessing";
+    };
+    readonly "marigold-depth": {
+        readonly category: "depth";
+        readonly defaultOptions: {
+            readonly ensemble_size: 10;
+            readonly num_inference_steps: 10;
+        };
+        readonly description: "Create depth maps using Marigold depth estimation.";
+        readonly endpoint: "fal-ai/imageutils/marigold-depth";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Marigold Depth Estimation";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
+        readonly task: "depth map";
+    };
+    readonly "midas-depth": {
+        readonly category: "depth";
+        readonly defaultOptions: {
+            readonly a: number;
+            readonly bg_th: 0.1;
+        };
+        readonly description: "Create MiDaS depth maps from input images.";
+        readonly endpoint: "fal-ai/imageutils/depth";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "MiDaS Depth Estimation";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
+        readonly task: "depth map";
+    };
+    readonly "midas-preprocessor": {
+        readonly category: "preprocess";
+        readonly description: "Generate MiDaS depth and normal maps for image workflows.";
+        readonly endpoint: "fal-ai/image-preprocessors/midas";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "MiDaS Preprocessor";
+        readonly outputKeys: ["depth_map", "normal_map"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas";
+        readonly task: "depth and normal preprocessing";
+    };
+    readonly mlsd: {
+        readonly category: "preprocess";
+        readonly description: "Detect straight line segments for architectural and interior control maps.";
+        readonly endpoint: "fal-ai/image-preprocessors/mlsd";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "M-LSD Line Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd";
+        readonly task: "line segment preprocessing";
+    };
+    readonly pidi: {
+        readonly category: "preprocess";
+        readonly description: "Generate PiDiNet soft edge maps from an input image.";
+        readonly endpoint: "fal-ai/image-preprocessors/pidi";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "PiDiNet Edge Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi";
+        readonly task: "edge preprocessing";
+    };
+    readonly "sam-preprocessor": {
+        readonly category: "preprocess";
+        readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
+        readonly endpoint: "fal-ai/image-preprocessors/sam";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SAM Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+        readonly task: "segmentation preprocessing";
+    };
+    readonly "sam2-auto": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly min_mask_region_area: 100;
+            readonly output_format: "png";
+            readonly points_per_side: 32;
+            readonly pred_iou_thresh: 0.88;
+            readonly stability_score_thresh: 0.95;
+        };
+        readonly description: "Automatically segment an image into combined and individual masks.";
+        readonly endpoint: "fal-ai/sam2/auto-segment";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SAM 2 Auto Segment";
+        readonly outputKeys: ["combined_mask", "individual_masks"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
+        readonly task: "automatic image segmentation";
+    };
+    readonly "sam3-1-image": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly max_masks: 3;
+            readonly output_format: "png";
+        };
+        readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
+        readonly endpoint: "fal-ai/sam-3-1/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SAM 3.1 Image";
+        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.01;
+        };
+        readonly pricing: "$0.01/request";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
+        readonly task: "promptable image segmentation";
+    };
+    readonly "sam3-1-video": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly prompt: "person";
+        };
+        readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
+        readonly endpoint: "fal-ai/sam-3-1/video";
+        readonly inputField: "video_url";
+        readonly inputKind: "video";
+        readonly name: "SAM 3.1 Video";
+        readonly outputKeys: ["video", "boundingbox_frames_zip"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.01/16 frames of video input";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
+        readonly task: "multi-object video segmentation";
+    };
+    readonly "sam3-image": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly max_masks: 3;
+            readonly output_format: "png";
+        };
+        readonly description: "Segment image objects with text, point, or box prompts.";
+        readonly endpoint: "fal-ai/sam-3/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SAM 3 Image";
+        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.005;
+        };
+        readonly pricing: "$0.005/request";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
+        readonly task: "promptable image segmentation";
+    };
+    readonly "sam3-image-rle": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly max_masks: 3;
+        };
+        readonly description: "Segment image objects and return run-length encoded masks.";
+        readonly endpoint: "fal-ai/sam-3/image-rle";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SAM 3 Image RLE";
+        readonly outputKeys: ["rle", "scores", "boxes", "metadata"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.005;
+        };
+        readonly pricing: "$0.005/request";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle";
+        readonly task: "promptable image segmentation to RLE";
+    };
+    readonly "sam3-video": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly detection_threshold: 0.5;
+            readonly prompt: "person";
+            readonly video_output_type: "X264 (.mp4)";
+        };
+        readonly description: "Segment and track prompted objects across video frames.";
+        readonly endpoint: "fal-ai/sam-3/video";
+        readonly inputField: "video_url";
+        readonly inputKind: "video";
+        readonly name: "SAM 3 Video";
+        readonly outputKeys: ["video", "boundingbox_frames_zip"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.005/16 frames of video input";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
+        readonly task: "promptable video segmentation";
+    };
+    readonly "sam3-video-rle": {
+        readonly category: "segmentation";
+        readonly defaultOptions: {
+            readonly apply_mask: true;
+            readonly detection_threshold: 0.5;
+            readonly prompt: "person";
+        };
+        readonly description: "Track prompted video objects and return RLE mask data.";
+        readonly endpoint: "fal-ai/sam-3/video-rle";
+        readonly inputField: "video_url";
+        readonly inputKind: "video";
+        readonly name: "SAM 3 Video RLE";
+        readonly outputKeys: ["video", "boundingbox_frames_zip"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.005/16 frames of video";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
+        readonly task: "promptable video segmentation to RLE";
+    };
+    readonly scribble: {
+        readonly category: "preprocess";
+        readonly description: "Turn an image into a scribble-style control map.";
+        readonly endpoint: "fal-ai/image-preprocessors/scribble";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Scribble Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble";
+        readonly task: "scribble preprocessing";
+    };
+    readonly teed: {
+        readonly category: "preprocess";
+        readonly description: "Generate TEED edge maps from an input image.";
+        readonly endpoint: "fal-ai/image-preprocessors/teed";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "TEED Edge Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed";
+        readonly task: "edge preprocessing";
+    };
+    readonly "zoe-depth": {
+        readonly category: "preprocess";
+        readonly description: "Generate ZoeDepth metric depth maps from an input image.";
+        readonly endpoint: "fal-ai/image-preprocessors/zoe";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "ZoeDepth Preprocessor";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
+        readonly task: "depth preprocessing";
+    };
+    readonly "bria-eraser": {
+        readonly category: "erase";
+        readonly description: "Commercial-safe removal of a masked region, inpainted from surrounding context.";
+        readonly endpoint: "fal-ai/bria/eraser";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Bria Eraser";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.04;
+        };
+        readonly pricing: "$0.04/generation";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/eraser";
+        readonly task: "masked object erasure";
+    };
+    readonly "bria-expand": {
+        readonly category: "reframe";
+        readonly description: "Expand an image onto a larger canvas, generating the new border area.";
+        readonly endpoint: "fal-ai/bria/expand";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Bria Image Expansion";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.04;
+        };
+        readonly pricing: "$0.04/generation";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/expand";
+        readonly task: "image outpainting";
+    };
+    readonly "bria-genfill": {
+        readonly category: "erase";
+        readonly description: "Generative fill of a masked region from a prompt, commercial-safe.";
+        readonly endpoint: "fal-ai/bria/genfill";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Bria GenFill";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.04;
+        };
+        readonly pricing: "$0.04/generation";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/genfill";
+        readonly task: "masked generative fill";
+    };
+    readonly "finegrain-eraser": {
+        readonly category: "erase";
+        readonly description: "Remove a prompted object and its shadows and reflections, filling the gap.";
+        readonly endpoint: "fal-ai/finegrain-eraser";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Finegrain Object Eraser";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.27;
+        };
+        readonly pricing: "$0.27/image at the default standard mode; $0.18 express, $0.36 premium";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/finegrain-eraser";
+        readonly task: "prompted object erasure";
+    };
+    readonly "flux-outpaint": {
+        readonly category: "reframe";
+        readonly description: "Outpaint an image by a per-edge pixel expansion with FLUX.2 pro.";
+        readonly endpoint: "fal-ai/flux-2-pro/outpaint";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "FLUX.2 Pro Outpaint";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.03 for the first output megapixel, then $0.015 per extra megapixel of input and output, rounded up";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/flux-2-pro/outpaint";
+        readonly task: "image outpainting";
+    };
+    readonly "iclight-v2": {
+        readonly category: "relight";
+        readonly description: "Relight a subject from a prompt, harmonising it with a new light direction.";
+        readonly endpoint: "fal-ai/iclight-v2";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "IC-Light v2";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.1;
+        };
+        readonly pricing: "$0.10/megapixel";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/iclight-v2";
+        readonly task: "prompted relighting";
+    };
+    readonly "ideogram-reframe": {
+        readonly category: "reframe";
+        readonly description: "Reframe an image to a new aspect ratio, generating the fill.";
+        readonly endpoint: "fal-ai/ideogram/v3/reframe";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Ideogram v3 Reframe";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.06;
+        };
+        readonly pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/reframe";
+        readonly task: "aspect ratio reframing";
+    };
+    readonly "lighting-restoration": {
+        readonly category: "relight";
+        readonly description: "Restore natural, even lighting across one or more input images.";
+        readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
+        readonly inputField: "image_urls";
+        readonly inputKind: "images";
+        readonly name: "Qwen Lighting Restoration";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.035;
+        };
+        readonly pricing: "$0.035/megapixel";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
+        readonly task: "lighting restoration";
+    };
+    readonly "object-removal": {
+        readonly category: "erase";
+        readonly description: "Remove a prompted object from an image and fill the gap.";
+        readonly endpoint: "fal-ai/object-removal";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Object Removal";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.024;
+        };
+        readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal";
+        readonly task: "prompted object removal";
+    };
+    readonly "object-removal-bbox": {
+        readonly category: "erase";
+        readonly description: "Remove whatever falls inside supplied bounding boxes.";
+        readonly endpoint: "fal-ai/object-removal/bbox";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Object Removal by Box";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.024;
+        };
+        readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox";
+        readonly task: "bounding box object removal";
+    };
+    readonly "object-removal-mask": {
+        readonly category: "erase";
+        readonly description: "Remove the masked region of an image and fill the gap.";
+        readonly endpoint: "fal-ai/object-removal/mask";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Object Removal by Mask";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.024;
+        };
+        readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask";
+        readonly task: "masked object removal";
+    };
+    readonly "remove-lighting": {
+        readonly category: "relight";
+        readonly description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.";
+        readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
+        readonly inputField: "image_urls";
+        readonly inputKind: "images";
+        readonly name: "Qwen Remove Lighting";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.035;
+        };
+        readonly pricing: "$0.035/megapixel";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
+        readonly task: "lighting removal";
+    };
+    readonly "smart-resize": {
+        readonly category: "reframe";
+        readonly description: "Resize one image to several target sizes, recomposing rather than cropping.";
+        readonly endpoint: "fal-ai/smart-resize";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Smart Resize";
+        readonly outputKeys: ["images", "results"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/smart-resize";
+        readonly task: "multi-size recomposition";
+    };
+    readonly "text-removal": {
+        readonly category: "erase";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Remove all rendered text from an image, rebuilding what sat behind it.";
+        readonly endpoint: "fal-ai/image-editing/text-removal";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Text Removal";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.04;
+        };
+        readonly pricing: "$0.04/image";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal";
+        readonly task: "text removal";
+    };
+    readonly "ben-v2": {
+        readonly category: "background";
+        readonly description: "Fast, high-quality background removal for images.";
+        readonly endpoint: "fal-ai/ben/v2/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "BEN v2 Background Removal";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.025;
+        };
+        readonly pricing: "$0.025/megapixel";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image";
+        readonly task: "image background removal";
+    };
+    readonly birefnet: {
+        readonly category: "background";
+        readonly defaultOptions: {
+            readonly model: "General Use (Light)";
+            readonly operating_resolution: "1024x1024";
+            readonly output_format: "png";
+            readonly refine_foreground: true;
+        };
+        readonly description: "High-resolution dichotomous image segmentation and background removal.";
         readonly endpoint: "fal-ai/birefnet/v2";
         readonly inputField: "image_url";
         readonly inputKind: "image";
         readonly name: "BirefNet Background Removal";
         readonly outputKeys: ["image", "mask_image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
         readonly pricing: "$0/compute-second listed by fal";
         readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
         readonly task: "image background removal";
@@ -989,7 +2602,11 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "Bria RMBG 2.0";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0.02/image";
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.018;
+        };
+        readonly pricing: "$0.018/generation";
         readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
         readonly task: "image background removal";
     };
@@ -1006,171 +2623,410 @@ declare const FAL_TOOLS: {
         readonly inputKind: "video";
         readonly name: "Bria Video Background Removal";
         readonly outputKeys: ["video"];
-        readonly pricing: "$0.14/sec";
+        readonly price: {
+            readonly kind: "second";
+            readonly usd: 0.00425;
+        };
+        readonly pricing: "$0.00425/sec";
+        readonly queued: true;
         readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
         readonly task: "video background removal";
     };
-    readonly "depth-anything": {
-        readonly category: "preprocess";
-        readonly description: "Generate Depth Anything v2 depth maps from input images.";
-        readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
+    readonly ddcolor: {
+        readonly category: "restoration";
+        readonly description: "Colourise black-and-white photographs.";
+        readonly endpoint: "fal-ai/ddcolor";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "Depth Anything v2 Preprocessor";
+        readonly name: "DDColor Colourisation";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
-        readonly task: "depth preprocessing";
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.001;
+        };
+        readonly pricing: "$0.001/megapixel";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/ddcolor";
+        readonly task: "photo colourisation";
     };
-    readonly lineart: {
-        readonly category: "preprocess";
+    readonly rembg: {
+        readonly category: "background";
         readonly defaultOptions: {
-            readonly coarse: false;
+            readonly crop_to_bbox: false;
         };
-        readonly description: "Generate line art/control-style edges from an input image.";
-        readonly endpoint: "fal-ai/image-preprocessors/lineart";
+        readonly description: "Generic image background removal utility.";
+        readonly endpoint: "fal-ai/imageutils/rembg";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "Line Art Preprocessor";
+        readonly name: "Remove Background";
         readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
         readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
-        readonly task: "image preprocessing";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
+        readonly task: "image background removal";
     };
-    readonly "marigold-depth": {
-        readonly category: "depth";
+    readonly "seedvr-upscale": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly ensemble_size: 10;
-            readonly num_inference_steps: 10;
+            readonly output_format: "png";
         };
-        readonly description: "Create depth maps using Marigold depth estimation.";
-        readonly endpoint: "fal-ai/imageutils/marigold-depth";
+        readonly description: "Diffusion image restoration and upscaling with SeedVR.";
+        readonly endpoint: "fal-ai/seedvr/upscale/image";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "Marigold Depth Estimation";
+        readonly name: "SeedVR Image Upscale";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-        readonly task: "depth map";
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.001;
+        };
+        readonly pricing: "$0.001/megapixel";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image";
+        readonly task: "image restoration and upscaling";
     };
-    readonly "midas-depth": {
-        readonly category: "depth";
+    readonly "topaz-adjust": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly a: number;
-            readonly bg_th: 0.1;
+            readonly output_format: "png";
         };
-        readonly description: "Create MiDaS depth maps from input images.";
-        readonly endpoint: "fal-ai/imageutils/depth";
+        readonly description: "Topaz exposure, white balance, and colour adjustment.";
+        readonly endpoint: "topaz/adjust/image";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "MiDaS Depth Estimation";
+        readonly name: "Topaz Adjust";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-        readonly task: "depth map";
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 per 24 output megapixels";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/adjust/image";
+        readonly task: "tonal adjustment";
     };
-    readonly "midas-preprocessor": {
-        readonly category: "preprocess";
-        readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-        readonly endpoint: "fal-ai/image-preprocessors/midas";
+    readonly "topaz-creative": {
+        readonly category: "restoration";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Topaz Bloom upscaling, which reimagines detail rather than preserving it.";
+        readonly endpoint: "topaz/upscale/image/creative";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "MiDaS Preprocessor";
-        readonly outputKeys: ["depth_map", "normal_map"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas";
-        readonly task: "depth and normal preprocessing";
+        readonly name: "Topaz Creative Upscale";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.96 per 24 output megapixels";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative";
+        readonly task: "creative image upscaling";
     };
-    readonly nsfw: {
-        readonly category: "moderation";
-        readonly description: "Predict whether one or more images contain NSFW concepts.";
-        readonly endpoint: "fal-ai/x-ailab/nsfw";
-        readonly inputField: "image_urls";
-        readonly inputKind: "images";
-        readonly name: "NSFW Checker";
-        readonly outputKeys: ["has_nsfw_concepts"];
-        readonly pricing: "$0.001/image";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-        readonly task: "vision moderation";
+    readonly "topaz-denoise": {
+        readonly category: "restoration";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Topaz noise reduction at source resolution.";
+        readonly endpoint: "topaz/denoise/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Topaz Denoise";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/denoise/image";
+        readonly task: "image denoising";
+    };
+    readonly "topaz-generative": {
+        readonly category: "restoration";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Topaz Wonder upscaling, which synthesises plausible detail as it enlarges.";
+        readonly endpoint: "topaz/upscale/image/generative";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Topaz Generative Upscale";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative";
+        readonly task: "generative image upscaling";
+    };
+    readonly "topaz-image": {
+        readonly category: "upscale";
+        readonly defaultOptions: {
+            readonly model: "Standard V2";
+            readonly output_format: "jpeg";
+            readonly upscale_factor: 2;
+        };
+        readonly description: "Professional Topaz image enhancement and upscaling.";
+        readonly endpoint: "fal-ai/topaz/upscale/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Topaz Image Upscale";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
+        readonly task: "image enhancement";
+    };
+    readonly "topaz-precision": {
+        readonly category: "restoration";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Topaz upscaling that preserves the original detail rather than inventing it.";
+        readonly endpoint: "topaz/upscale/image/precision";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Topaz Precision Upscale";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 per 24 output megapixels, any precision model";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/precision";
+        readonly task: "faithful image upscaling";
+    };
+    readonly "topaz-restore": {
+        readonly category: "restoration";
+        readonly defaultOptions: {
+            readonly output_format: "png";
+        };
+        readonly description: "Topaz restoration of damaged or degraded photographs at source resolution.";
+        readonly endpoint: "topaz/restore/image";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Topaz Restore";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/restore/image";
+        readonly task: "photo restoration";
     };
-    readonly rembg: {
-        readonly category: "background";
+    readonly "topaz-sharpen": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly crop_to_bbox: false;
+            readonly output_format: "png";
         };
-        readonly description: "Generic image background removal utility.";
-        readonly endpoint: "fal-ai/imageutils/rembg";
+        readonly description: "Topaz deblurring and sharpening at source resolution.";
+        readonly endpoint: "topaz/sharpen/image";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "Remove Background";
+        readonly name: "Topaz Sharpen";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-        readonly task: "image background removal";
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/sharpen/image";
+        readonly task: "image sharpening";
     };
-    readonly "sam-preprocessor": {
-        readonly category: "preprocess";
-        readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-        readonly endpoint: "fal-ai/image-preprocessors/sam";
+    readonly "topaz-transparent": {
+        readonly category: "restoration";
+        readonly description: "Topaz upscaling that preserves the alpha channel end to end.";
+        readonly endpoint: "topaz/upscale/image/transparent";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "SAM Preprocessor";
+        readonly name: "Topaz Transparent Upscale";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
-        readonly task: "segmentation preprocessing";
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: number;
+        };
+        readonly pricing: "$0.08 per 24 output megapixels";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/transparent";
+        readonly task: "transparent image upscaling";
     };
-    readonly "sam2-auto": {
-        readonly category: "segmentation";
+    readonly "topaz-video": {
+        readonly category: "upscale";
         readonly defaultOptions: {
-            readonly min_mask_region_area: 100;
-            readonly output_format: "png";
-            readonly points_per_side: 32;
-            readonly pred_iou_thresh: 0.88;
-            readonly stability_score_thresh: 0.95;
+            readonly model: "Proteus";
+            readonly upscale_factor: 2;
         };
-        readonly description: "Automatically segment an image into combined and individual masks.";
-        readonly endpoint: "fal-ai/sam2/auto-segment";
+        readonly description: "Professional Topaz video enhancement and upscaling.";
+        readonly endpoint: "fal-ai/topaz/upscale/video";
+        readonly inputField: "video_url";
+        readonly inputKind: "video";
+        readonly name: "Topaz Video Upscale";
+        readonly outputKeys: ["video"];
+        readonly price: {
+            readonly kind: "second";
+            readonly usd: 0.01;
+        };
+        readonly pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
+        readonly task: "video enhancement";
+    };
+    readonly "hunyuan3d-v3": {
+        readonly category: "3d";
+        readonly description: "Reconstruct a textured 3D mesh from a single image, with optional multi-view inputs.";
+        readonly endpoint: "fal-ai/hunyuan3d-v3/image-to-3d";
+        readonly inputField: "input_image_url";
+        readonly inputKind: "image";
+        readonly name: "Hunyuan3D v3 Image to 3D";
+        readonly outputKeys: ["model_glb", "model_urls", "thumbnail"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.375;
+        };
+        readonly pricing: "$0.375/generation at the default Normal type; $0.45 low poly, $0.225 geometry only, and $0.15 each for PBR, multi-view, or a custom face count";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/hunyuan3d-v3/image-to-3d";
+        readonly task: "single-image 3D reconstruction";
+    };
+    readonly "ideogram-layerize-text": {
+        readonly category: "layers";
+        readonly description: "Split an image into background image layers plus editable HTML text containers.";
+        readonly endpoint: "fal-ai/ideogram/v3/layerize-text";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "SAM 2 Auto Segment";
-        readonly outputKeys: ["combined_mask", "individual_masks"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
-        readonly task: "automatic image segmentation";
+        readonly name: "Ideogram v3 Text Layerize";
+        readonly outputKeys: ["image_layers", "image", "text_html", "text_containers"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.09;
+        };
+        readonly pricing: "$0.09/image";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/layerize-text";
+        readonly task: "text and image layer extraction";
     };
-    readonly "sam3-1-image": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-            readonly output_format: "png";
+    readonly "ideogram-tiling": {
+        readonly category: "material";
+        readonly description: "Generate a seamlessly tiling texture, optionally conditioned on a source image.";
+        readonly endpoint: "ideogram/v4/tiling";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Ideogram v4 Tiling";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.06;
         };
-        readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-        readonly endpoint: "fal-ai/sam-3-1/image";
+        readonly pricing: "$0.06/megapixel at the default BALANCED speed; $0.03 turbo, $0.10 quality";
+        readonly sourceUrl: "https://fal.ai/models/ideogram/v4/tiling";
+        readonly task: "seamless texture generation";
+    };
+    readonly image2svg: {
+        readonly category: "vector";
+        readonly description: "Trace a raster image into layered SVG paths.";
+        readonly endpoint: "fal-ai/image2svg";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "SAM 3.1 Image";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-        readonly task: "promptable image segmentation";
+        readonly name: "Image to SVG";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.005;
+        };
+        readonly pricing: "$0.005/image";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image2svg";
+        readonly task: "raster to vector tracing";
     };
-    readonly "sam3-1-video": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly prompt: "person";
+    readonly patina: {
+        readonly category: "material";
+        readonly description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.";
+        readonly endpoint: "fal-ai/patina";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Patina PBR Maps";
+        readonly outputKeys: ["images"];
+        readonly outputLabels: {
+            readonly images: {
+                readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
+                readonly fromOption: "maps";
+            };
         };
-        readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
-        readonly endpoint: "fal-ai/sam-3-1/video";
-        readonly inputField: "video_url";
-        readonly inputKind: "video";
-        readonly name: "SAM 3.1 Video";
-        readonly outputKeys: ["video", "boundingbox_frames_zip"];
-        readonly pricing: "fal pricing varies by frame count";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
-        readonly task: "multi-object video segmentation";
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.01 base plus $0.01/megapixel per output map, so all 5 maps on a 1MP image cost $0.06; the listed rate is per map";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/patina";
+        readonly task: "PBR material decomposition";
+    };
+    readonly "patina-extract": {
+        readonly category: "material";
+        readonly description: "Extract a tiling PBR material from a prompted region of a photograph.";
+        readonly endpoint: "fal-ai/patina/material/extract";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Patina Material Extract";
+        readonly outputKeys: ["images"];
+        readonly outputLabels: {
+            readonly images: {
+                readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
+                readonly fromOption: "maps";
+            };
+        };
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.10 base only; add $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract";
+        readonly task: "tiling material extraction";
+    };
+    readonly "qwen-layered": {
+        readonly category: "layers";
+        readonly description: "Split an image into a configurable number of stacked RGBA layers.";
+        readonly endpoint: "fal-ai/qwen-image-layered";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Qwen Image Layered";
+        readonly outputKeys: ["images"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.05 per image; fal does not say whether that counts the input image or each of the generated layers, so no estimate is reported";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered";
+        readonly task: "image layer decomposition";
+    };
+    readonly "recraft-vectorize": {
+        readonly category: "vector";
+        readonly description: "Convert a raster image into a clean SVG.";
+        readonly endpoint: "fal-ai/recraft/vectorize";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Recraft Vectorize";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.04;
+        };
+        readonly pricing: "$0.04/image, $0.08 with a vector style";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/recraft/vectorize";
+        readonly task: "raster to vector conversion";
     };
     readonly "sam3-3d-align": {
         readonly category: "3d";
@@ -1179,8 +3035,12 @@ declare const FAL_TOOLS: {
         readonly inputField: "image_url";
         readonly inputKind: "image";
         readonly name: "SAM 3D Align";
-        readonly outputKeys: ["scene_glb", "metadata", "artifacts_zip"];
-        readonly pricing: "fal pricing varies by scene";
+        readonly outputKeys: ["scene_glb", "model_glb", "visualization", "body_mesh_ply", "metadata"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
+        readonly queued: true;
         readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align";
         readonly task: "3D scene alignment";
     };
@@ -1197,7 +3057,11 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "SAM 3D Body";
         readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
-        readonly pricing: "$0.015/inference";
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
+        readonly queued: true;
         readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body";
         readonly task: "single-image 3D body reconstruction";
     };
@@ -1212,116 +3076,311 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "SAM 3D Objects";
         readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
-        readonly pricing: "$0.02/generation";
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.02 per unit; fal does not define a unit, and this endpoint returns one mesh per detected object, so no estimate is reported";
+        readonly queued: true;
         readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
         readonly task: "single-image 3D object reconstruction";
     };
-    readonly "sam3-image": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-            readonly output_format: "png";
-        };
-        readonly description: "Segment image objects with text, point, or box prompts.";
-        readonly endpoint: "fal-ai/sam-3/image";
+    readonly "seedream-layerize": {
+        readonly category: "layers";
+        readonly description: "Split an image into editable Seedream layers plus flattened previews.";
+        readonly endpoint: "bytedance/seedream/v5/pro/layerize";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "SAM 3 Image";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
-        readonly task: "promptable image segmentation";
+        readonly name: "Seedream v5 Pro Layerize";
+        readonly outputKeys: ["layers", "images"];
+        readonly outputLabels: {
+            readonly layers: {
+                readonly fromItem: {
+                    readonly nameField: "name";
+                    readonly orderField: "z_index";
+                };
+            };
+        };
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize";
+        readonly task: "image layer decomposition";
     };
-    readonly "sam3-image-rle": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
+    readonly "seedvr-seamless": {
+        readonly category: "material";
+        readonly description: "Upscale a tiling texture while keeping its edges seamless. ";
+        readonly endpoint: "fal-ai/seedvr/upscale/image/seamless";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "SeedVR Seamless Upscale";
+        readonly outputKeys: ["image"];
+        readonly price: {
+            readonly kind: "megapixel";
+            readonly usd: 0.0025;
         };
-        readonly description: "Segment image objects and return run-length encoded masks.";
-        readonly endpoint: "fal-ai/sam-3/image-rle";
+        readonly pricing: "$0.0025/megapixel";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless";
+        readonly task: "seamless texture upscaling";
+    };
+    readonly "trellis-2": {
+        readonly category: "3d";
+        readonly description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.";
+        readonly endpoint: "fal-ai/trellis-2";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "SAM 3 Image RLE";
-        readonly outputKeys: ["rle_masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle";
-        readonly task: "promptable image segmentation to RLE";
+        readonly name: "TRELLIS 2";
+        readonly outputKeys: ["model_glb"];
+        readonly price: {
+            readonly kind: "call";
+            readonly usd: 0.3;
+        };
+        readonly pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/trellis-2";
+        readonly task: "single-image 3D reconstruction";
     };
-    readonly "sam3-video": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly detection_threshold: 0.5;
-            readonly prompt: "person";
-            readonly video_output_type: "X264 (.mp4)";
+    readonly "got-ocr": {
+        readonly category: "analysis";
+        readonly description: "Transcribe text from one or more images, optionally as formatted multi-page output.";
+        readonly endpoint: "fal-ai/got-ocr/v2";
+        readonly inputField: "input_image_urls";
+        readonly inputKind: "images";
+        readonly name: "GOT-OCR 2.0";
+        readonly outputKeys: ["outputs"];
+        readonly price: {
+            readonly kind: "metered";
         };
-        readonly description: "Segment and track prompted objects across video frames.";
-        readonly endpoint: "fal-ai/sam-3/video";
-        readonly inputField: "video_url";
-        readonly inputKind: "video";
-        readonly name: "SAM 3 Video";
-        readonly outputKeys: ["video", "boundingbox_frames_zip"];
-        readonly pricing: "$0.005/16 frames";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
-        readonly task: "promptable video segmentation";
+        readonly pricing: "$0.05/image";
+        readonly queued: true;
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2";
+        readonly task: "optical character recognition";
     };
-    readonly "sam3-video-rle": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly detection_threshold: 0.5;
-            readonly prompt: "person";
+    readonly "moondream-caption": {
+        readonly category: "analysis";
+        readonly description: "Write a short, normal, or long caption for an image.";
+        readonly endpoint: "fal-ai/moondream3-preview/caption";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Moondream 3 Caption";
+        readonly outputKeys: ["output"];
+        readonly price: {
+            readonly kind: "metered";
         };
-        readonly description: "Track prompted video objects and return RLE mask data.";
-        readonly endpoint: "fal-ai/sam-3/video-rle";
-        readonly inputField: "video_url";
-        readonly inputKind: "video";
-        readonly name: "SAM 3 Video RLE";
-        readonly outputKeys: ["rle_masks", "metadata"];
-        readonly pricing: "$0.005/16 frames";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
-        readonly task: "promptable video segmentation to RLE";
+        readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption";
+        readonly task: "image captioning";
     };
-    readonly "topaz-image": {
-        readonly category: "upscale";
-        readonly defaultOptions: {
-            readonly model: "Standard V2";
-            readonly output_format: "jpeg";
-            readonly upscale_factor: 2;
+    readonly "moondream-detect": {
+        readonly category: "analysis";
+        readonly description: "Detect prompted objects and return their bounding boxes, with an optional preview.";
+        readonly endpoint: "fal-ai/moondream3-preview/detect";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Moondream 3 Detect";
+        readonly outputKeys: ["objects", "image"];
+        readonly price: {
+            readonly kind: "metered";
         };
-        readonly description: "Professional Topaz image enhancement and upscaling.";
-        readonly endpoint: "fal-ai/topaz/upscale/image";
+        readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect";
+        readonly task: "object detection";
+    };
+    readonly "moondream-point": {
+        readonly category: "analysis";
+        readonly description: "Return point coordinates for every instance of a prompted subject.";
+        readonly endpoint: "fal-ai/moondream3-preview/point";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "Topaz Image Upscale";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0.08+ by output megapixels";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-        readonly task: "image enhancement";
+        readonly name: "Moondream 3 Point";
+        readonly outputKeys: ["points", "image"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point";
+        readonly task: "object pointing";
     };
-    readonly "topaz-video": {
-        readonly category: "upscale";
-        readonly defaultOptions: {
-            readonly model: "Proteus";
-            readonly upscale_factor: 2;
+    readonly "moondream-query": {
+        readonly category: "analysis";
+        readonly description: "Answer a free-form question about an image, with reasoning.";
+        readonly endpoint: "fal-ai/moondream3-preview/query";
+        readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Moondream 3 Query";
+        readonly outputKeys: ["output", "reasoning"];
+        readonly price: {
+            readonly kind: "metered";
         };
-        readonly description: "Professional Topaz video enhancement and upscaling.";
-        readonly endpoint: "fal-ai/topaz/upscale/video";
-        readonly inputField: "video_url";
-        readonly inputKind: "video";
-        readonly name: "Topaz Video Upscale";
-        readonly outputKeys: ["video"];
-        readonly pricing: "$0.01-$0.08/sec by output resolution";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-        readonly task: "video enhancement";
+        readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/query";
+        readonly task: "visual question answering";
+    };
+    readonly nsfw: {
+        readonly category: "moderation";
+        readonly description: "Predict whether one or more images contain NSFW concepts.";
+        readonly endpoint: "fal-ai/x-ailab/nsfw";
+        readonly inputField: "image_urls";
+        readonly inputKind: "images";
+        readonly name: "NSFW Checker";
+        readonly outputKeys: ["has_nsfw_concepts"];
+        readonly price: {
+            readonly kind: "metered";
+        };
+        readonly pricing: "$0.001/image";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
+        readonly task: "vision moderation";
     };
 };
-declare const FAL_TOOLS_CHECKED_AT = "2026-05-12";
+declare const FAL_TOOLS_CHECKED_AT = "2026-08-23";
 declare const FAL_TOOL_IDS: (keyof typeof FAL_TOOLS)[];
 type FalToolId = (typeof FAL_TOOL_IDS)[number];
 declare function isFalToolId(tool: string): tool is FalToolId;
 declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
 
-export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type QueuedJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, enrichPrompt, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv, sanitizePrompt };
+/**
+ * What a tool run costs, before it happens and after.
+ *
+ * The registry's `price` is a rate, not a total. Turning a rate into a figure
+ * needs something only one of the two moments has:
+ *
+ *   - Before the call, a `call` price is the whole answer and nothing else is.
+ *     A per-megapixel rate depends on an output that does not exist yet.
+ *   - After the call, the output exists and has been measured, so a
+ *     per-megapixel rate resolves exactly. Most of the restoration suite is
+ *     priced this way, which means most of what looked unknowable at dry-run
+ *     time is knowable by the time it reaches history.
+ *
+ * Both functions return `null` rather than `0` where the figure is genuinely
+ * unavailable. Zero is a claim that something was free, and every price defect
+ * found in this registry has been a confident wrong number rather than an
+ * absent one.
+ */
+
+/** Pixel dimensions of one file an endpoint returned. */
+interface OutputDimensions {
+    height?: number;
+    width?: number;
+}
+/** A cost, and enough context for a caller to say why it is what it is. */
+interface ResolvedCost {
+    /** USD, or null when the rate cannot be resolved against what we know. */
+    usd: number | null;
+    /**
+     * Whether `usd` was measured from real output or projected from the rate
+     * alone. Callers that display a figure should say which; an estimate and a
+     * bill are not the same claim.
+     */
+    basis: "measured" | "projected" | "unknown";
+}
+/**
+ * The figure to show before a run, from the rate alone.
+ *
+ * Only a flat per-call price survives this: everything else depends on an
+ * output that does not exist yet, and guessing its size is how a dry run comes
+ * to promise a number the invoice contradicts.
+ */
+declare function projectedToolCost(price: FalToolPrice): ResolvedCost;
+/**
+ * The figure to record after a run, from the rate and the output it produced.
+ *
+ * A per-megapixel rate becomes exact here, because the files have been written
+ * and measured. Per-second rates need a duration nothing in the image path
+ * carries, and metered endpoints publish no rate at all, so both stay unknown.
+ */
+declare function measuredToolCost(price: FalToolPrice, outputs: readonly OutputDimensions[]): ResolvedCost;
+/**
+ * Render a cost for a human. `null` never becomes "$0.000" - it says what it
+ * means, which is that nobody knows.
+ */
+declare function formatCost(usd: number | null): string;
+/**
+ * Sum costs that are known, and count the ones that are not.
+ *
+ * A running total that silently drops unknown runs reads as complete. Callers
+ * are expected to show both halves: "$1.23 plus 4 metered runs" is honest where
+ * "$1.23" is not.
+ */
+declare function sumCosts(costs: readonly (number | null)[]): {
+    known: number;
+    unknown: number;
+};
+
+/** One argument an endpoint accepts. */
+interface FalToolParameter {
+    /** Argument name, exactly as fal expects it in the request body. */
+    key: string;
+    /** fal's own default when the caller sends nothing. */
+    fallback?: boolean | number | string | readonly unknown[];
+    /** Whether fal rejects the request without it. */
+    required?: true;
+    /** Compact rendering of fal's declared type, e.g. `enum(a|b)`, `list[string]`. */
+    type: string;
+}
+declare const FAL_TOOL_PARAMETERS: Record<string, readonly FalToolParameter[]>;
+/** Arguments a tool accepts, including ones Motif does not surface as flags. */
+declare function falToolParameters(tool: string): readonly FalToolParameter[];
+
+interface ModelOutputShape {
+    /** File container the endpoint returns. */
+    container: string;
+    /** Whether the encoding preserves every pixel exactly. */
+    lossless: boolean;
+    /** Bits per channel. */
+    bitDepth?: number;
+    /** Whether the returned file carries an alpha channel. */
+    hasAlpha?: boolean;
+    /** JPEG chroma subsampling, e.g. "4:4:4" or "4:2:0". Absent for lossless containers. */
+    subsampling?: string;
+}
+declare const MODEL_OUTPUT: Record<string, ModelOutputShape>;
+
+/**
+ * What a model returns, and whether you can get something lossless out of it.
+ *
+ * Two facts live in different places and neither is useful alone:
+ *
+ *   - `MODEL_OUTPUT` (generated, measured from real bytes) says what arrives
+ *     when you ask for nothing.
+ *   - `supportsOutputFormat` on the model says whether you are allowed to ask
+ *     for something else.
+ *
+ * A caller who reads only the first concludes `flux2-pro` is lossy; it defaults
+ * to JPEG but returns PNG on request. A caller who reads only the second
+ * concludes `seedream5` is fine; the flag is false, and what that actually
+ * means is 4:2:0 chroma - averaged over 2x2 blocks, invisible in a photograph
+ * and destructive to anything dividing by alpha at a soft edge.
+ *
+ * So the answer is derived from both at read time rather than written down a
+ * third time. Every price and output-key defect in this registry came from one
+ * fact stored twice.
+ */
+
+/** Whether a lossless file can be obtained, and what it costs to ask. */
+type LosslessAvailability = 
+/** Lossless by default; ask for nothing. */
+"default"
+/** Lossy by default, lossless when `outputFormat` is set. */
+ | "on-request"
+/** No lossless route: the endpoint returns a lossy container and rejects the argument. */
+ | "unavailable"
+/** Not probed. Absence of evidence, not evidence of a limitation. */
+ | "unknown";
+/** Measured shape of what a model returns by default, if it has been probed. */
+declare function modelOutput(model: string): ModelOutputShape | undefined;
+/**
+ * Whether this model can produce a lossless file at all.
+ *
+ * The question a caller actually has, answered from the measured default and
+ * the accepted arguments together.
+ */
+declare function losslessAvailability(model: string): LosslessAvailability;
+/**
+ * One line a human or an agent can act on, e.g.
+ * `"jpeg 4:2:0, no lossless route"` or `"jpeg 4:4:4, PNG on request"`.
+ */
+declare function describeModelOutput(model: string): string;
+
+export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FAL_TOOL_PARAMETERS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolParameter, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, type LosslessAvailability, MODELS, MODEL_OUTPUT, type ModelConfig, type ModelOutputShape, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type OutputDimensions, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type ResolvedCost, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, describeModelOutput, enrichPrompt, estimateCost, estimateVideoCost, falToolParameters, formatCost, getFalKeyFromEnv, isFalToolId, losslessAvailability, measuredToolCost, modelOutput, motifEnvSchema, parseMotifEnv, projectedToolCost, sanitizePrompt, sumCosts };