@howells/motif-sdk 6.0.0 → 7.0.0

package/dist/registry.d.ts

@@ -0,0 +1,1757 @@
+//#region src/types.d.ts
+/** ─── Model Types ─────────────────────────────────────────────── */
+type AspectRatio = "auto" | "8:1" | "4:1" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16" | "1:4" | "1:8";
+type Resolution = "0.5K" | "1K" | "2K" | "4K";
+type ModelType = "generation" | "utility" | "video";
+/** `gif` is an animation and `svg` a vector image, on the Models that make them. */
+type ImageOutputFormat = "jpeg" | "png" | "webp" | "gif" | "svg";
+type ImageQuality = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
+interface CustomImageSize {
+  height: number;
+  width: number;
+}
+/** Limits an endpoint puts on an exact `{ width, height }` image size. */
+interface ImageSizeBounds {
+  /** Largest width or height over smallest, e.g. 3 for 3:1. */
+  maxRatio?: number;
+  maxEdge?: number;
+  maxPixels?: number;
+  minEdge?: number;
+  minPixels?: number;
+  /** Both edges must be multiples of this. Motif uses 16 when absent. */
+  multipleOf?: number;
+}
+/** How the model accepts image dimensions */
+type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
+type QualityTier = "good" | "better" | "best" | "frontier";
+type SpeedTier = "fast" | "balanced" | "slow" | "very_slow" | "unknown";
+type PriceTier = "budget" | "standard" | "premium" | "ultra" | "variable";
+interface FalPricing {
+  checkedAt: string;
+  currency: "USD";
+  endpointId: string;
+  estimatedCostPerImageUsd?: number;
+  source: "fal-pricing-api";
+  unit: string;
+  unitPrice: number;
+}
+interface LeaderboardMetric {
+  elo: number;
+  rank: number;
+  winRate?: number;
+}
+interface ModelBenchmark {
+  artificialAnalysis?: {
+    editing?: LeaderboardMetric;
+    sourceUrls: string[];
+    snapshotDate: string;
+    textToImage?: LeaderboardMetric;
+  };
+  speed?: {
+    medianSeconds?: number;
+    p95Seconds?: number;
+    source: "artificial-analysis-models";
+  };
+  tiers?: {
+    price: PriceTier;
+    quality: QualityTier;
+    speed: SpeedTier;
+  };
+  useCase?: string;
+}
+interface ModelConfig {
+  benchmark?: ModelBenchmark;
+  /**
+   * The fal endpoint's `image_size` also takes an exact `{ width, height }`,
+   * within these limits read from fal's OpenAPI schema. Absent means only the
+   * named presets are sent. Only meaningful with `sizeMode: "image_size_enum"`.
+   */
+  customImageSize?: ImageSizeBounds;
+  /** Explicit fal streaming support for generation and edit routes. */
+  streaming?: {
+    generation: boolean;
+    edit: boolean;
+  };
+  editEndpoint?: string;
+  editImagesField?: "image_urls" | "image_url";
+  endpoint: string;
+  falPricing?: FalPricing;
+  maxReferenceImages?: number;
+  name: string;
+  pricing: string;
+  /** Null means token-metered with no per-image estimate. */
+  pricePerImageUsd?: number | null;
+  /** How this model accepts dimensions (default: "aspect_ratio") */
+  sizeMode?: SizeMode;
+  supportsAspect: boolean;
+  /**
+   * The aspect ratios fal's `aspect_ratio` enum accepts, where it is narrower
+   * than `ASPECT_RATIOS`. Absent means every ratio is accepted.
+   */
+  supportedAspects?: readonly AspectRatio[];
+  /** The resolutions fal's `resolution` enum accepts, where it is narrower than `RESOLUTIONS`. */
+  supportedResolutions?: readonly Resolution[];
+  supportsBackground?: boolean;
+  supportsEdit: boolean;
+  supportsExpandPrompt?: boolean;
+  supportsGuidanceScale?: boolean;
+  supportsGoogleSearch?: boolean;
+  supportsInferenceSteps?: boolean;
+  supportsLimitGenerations?: boolean;
+  supportsMaskImage?: boolean;
+  maskImageField?: "mask_image_url" | "mask_url";
+  /**
+   * Takes `markup_image_url`: a transparent PNG of annotations (circles,
+   * arrows, notes) the size of the first edit image, guiding its edit.
+   */
+  supportsMarkupImage?: boolean;
+  /**
+   * An edit with no aspect asked for sends `image_size: "auto"`, so the
+   * result keeps the edited image's shape. For Models whose fal edit
+   * endpoint takes `auto`.
+   */
+  autoEditSize?: boolean;
+  supportsNegativePrompt?: boolean;
+  supportsNumImages: boolean;
+  supportsOutputFormat?: boolean;
+  /** Formats the Model returns. Absent means jpeg, png and webp. */
+  supportedOutputFormats?: readonly ImageOutputFormat[];
+  /** Formats an edit returns, where they differ from `supportedOutputFormats`. */
+  supportedEditOutputFormats?: readonly ImageOutputFormat[];
+  supportsQuality?: boolean;
+  /** Default matching the quality variant used in this Model's ranking. */
+  defaultQuality?: ImageQuality;
+  supportedQualities?: readonly ImageQuality[];
+  supportsRenderingSpeed?: boolean;
+  supportsResolution: boolean;
+  supportsSafetyTolerance?: boolean;
+  supportsSafetyChecker?: boolean;
+  supportsSeed?: boolean;
+  supportsSyncMode?: boolean;
+  supportsThinkingLevel?: boolean;
+  supportsWebSearch?: boolean;
+  /**
+   * The endpoint only makes transparent images and takes no `background`
+   * parameter (Ideogram V3 Transparent). Every output has an alpha channel.
+   */
+  transparentOutput?: boolean;
+  type: ModelType;
+  /** Use fal queue submit/status/result even for generate() calls. */
+  useQueue?: boolean;
+}
+//#endregion
+//#region src/aspects.d.ts
+/** Pixel sizes of fal's named `image_size` presets. `auto` has none. */
+export declare const FAL_PRESET_SIZES: Readonly<Record<string, CustomImageSize>>;
+//#endregion
+//#region src/cost.d.ts
+/**
+ * Estimate cost based on model and settings. `editImages` is the number of
+ * input images on an edit, for Models whose edits cost more than generation.
+ */
+export declare function estimateCost(model: string, resolution?: Resolution, numImages?: number, editImages?: number): number | null;
+//#endregion
+//#region src/models.d.ts
+export declare const MODELS: Record<string, ModelConfig>;
+//#endregion
+//#region src/tool-types.d.ts
+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;
+  /** `usd` is per output image, multiplied by the body's `num_images`. */
+  perImage?: true;
+  /**
+   * USD added when the request body sets a boolean key true, for options
+   * fal bills on top of the call, such as rigging a mesh.
+   */
+  extras?: Readonly<Record<string, number>>;
+  /**
+   * Body keys `usd` is multiplied by: an array by its length, a number by
+   * its value, an absent key by 1. Smart Resize bills each target size.
+   */
+  per?: readonly string[];
+  /** USD added once per request, such as a vision analysis fee. */
+  fee?: number;
+  /** Multipliers by a body key's value: `{ resolution: { "4K": 2 } }`. */
+  multipliers?: Readonly<Record<string, Readonly<Record<string, number>>>>;
+} | {
+  kind: "megapixel";
+  usd: number;
+} |
+/**
+ * `usd` for every started `megapixels` of each output, at least one step:
+ * Topaz bills $0.08 for any output up to 24MP, not $0.08/24 per megapixel.
+ */
+{
+  kind: "megapixel-step";
+  megapixels: number;
+  usd: number;
+} |
+/**
+ * FLUX.2 pricing: `first` for the first megapixel of output, then `extra`
+ * for every further megapixel of input and output, each rounded up.
+ */
+{
+  kind: "megapixel-first";
+  extra: number;
+  first: number;
+} |
+/**
+ * PBR material maps: `base` per request, `perMegapixel` per megapixel of
+ * the material, `perMapMegapixel` per megapixel of each map, and an
+ * `upscale` surcharge per pre-upscale megapixel per map, keyed by factor.
+ */
+{
+  kind: "maps";
+  base: number;
+  perMapMegapixel: number;
+  perMegapixel: number;
+  upscale?: Readonly<Record<string, number>>;
+} |
+/** Per second of source video; per compute-second when the input is not a video. */
+{
+  kind: "second";
+  usd: number;
+} |
+/**
+ * Per second of output video, tiered by the output's shorter side:
+ * `tiers` in ascending `upTo` lines, the last with no `upTo`. Doubled at
+ * `doubleAtFps` or above, halved when the body's `model` is `halfWithModel`.
+ */
+{
+  kind: "video-second";
+  doubleAtFps?: number;
+  halfWithModel?: string;
+  tiers: readonly {
+    upTo?: number;
+    usd: number;
+  }[];
+} |
+/** `usd` for every started `frames` frames of source video. */
+{
+  kind: "frames";
+  frames: number;
+  usd: number;
+} |
+/**
+ * Per million input and output tokens. fal bills the tokens a run used,
+ * so a projection needs `inputTokens` and `outputTokens` estimates.
+ */
+{
+  kind: "token";
+  inputPerMillion: number;
+  inputTokens: number;
+  outputPerMillion: number;
+  outputTokens: number;
+} | {
+  kind: "metered";
+};
+interface FalToolConfig {
+  category: "3d" | "analysis" | "background" | "depth" | "erase" | "layers" | "material" | "moderation" | "preprocess" | "reframe" | "relight" | "restoration" | "restyle" | "segmentation" | "try-on" | "upscale" | "vector";
+  defaultOptions?: Record<string, unknown>;
+  description: string;
+  endpoint: string;
+  inputField: "content_image_url" | "image_url" | "image_urls" | "input_image_url" | "input_image_urls" | "person_image_url" | "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;
+  /**
+   * Body key for the one Reference the tool takes beside its Source: the style
+   * a restyle copies, the garment in a try-on. Absent on tools that take none.
+   */
+  referenceField?: "product_image_url" | "style_image_url";
+  /**
+   * Endpoint routinely exceeds the 120s sync timeout; callers should use the
+   * queue path.
+   */
+  queued?: true;
+  sourceUrl: string;
+  task: string;
+}
+//#endregion
+//#region src/tools.d.ts
+export declare const FAL_TOOLS: {
+  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: "call";
+      readonly per: readonly ["input_image_urls"];
+      readonly usd: 0.05;
+    };
+    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 inputPerMillion: 0.4;
+      readonly inputTokens: 737;
+      readonly kind: "token";
+      readonly outputPerMillion: 3.5;
+      readonly outputTokens: 200;
+    };
+    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 inputPerMillion: 0.4;
+      readonly inputTokens: 737;
+      readonly kind: "token";
+      readonly outputPerMillion: 3.5;
+      readonly outputTokens: 100;
+    };
+    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 inputPerMillion: 0.4;
+      readonly inputTokens: 737;
+      readonly kind: "token";
+      readonly outputPerMillion: 3.5;
+      readonly outputTokens: 100;
+    };
+    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 inputPerMillion: 0.4;
+      readonly inputTokens: 737;
+      readonly kind: "token";
+      readonly outputPerMillion: 3.5;
+      readonly outputTokens: 500;
+    };
+    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: "call";
+      readonly per: readonly ["image_urls"];
+      readonly usd: 0.001;
+    };
+    readonly pricing: "$0.001/image";
+    readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
+    readonly task: "vision moderation";
+  };
+  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 "meshy-v7": {
+    readonly category: "3d";
+    readonly description: "Make a textured 3D mesh from one image, optionally rigged for animation.";
+    readonly endpoint: "meshy/v7/image-to-3d";
+    readonly inputField: "image_url";
+    readonly inputKind: "image";
+    readonly name: "Meshy v7 Image to 3D";
+    readonly outputKeys: ["model_glb", "model_urls", "thumbnail", "rigged_character_glb", "rigged_character_fbx"];
+    readonly price: {
+      readonly extras: {
+        readonly enable_animation: 0.12;
+        readonly enable_rigging: 0.2;
+        readonly ultra_mode: 0.2;
+      };
+      readonly kind: "call";
+      readonly usd: 1.2;
+    };
+    readonly pricing: "$1.20/generation at the default textured model; $0.80 untextured, $1.40 ultra, plus $0.20 for rigging and $0.12 for animation";
+    readonly queued: true;
+    readonly sourceUrl: "https://fal.ai/models/meshy/v7/image-to-3d";
+    readonly task: "single-image 3D reconstruction";
+  };
+  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 base: 0.01;
+      readonly kind: "maps";
+      readonly perMapMegapixel: 0.01;
+      readonly perMegapixel: 0;
+    };
+    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 base: 0.1;
+      readonly kind: "maps";
+      readonly perMapMegapixel: 0.01;
+      readonly perMegapixel: 0.02;
+      readonly upscale: {
+        readonly "2": 0.004;
+        readonly "4": 0.016;
+      };
+    };
+    readonly pricing: "$0.10 plus $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17; upscaling adds $0.004 (2x) or $0.016 (4x) per pre-upscale megapixel per map";
+    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: "call";
+      readonly usd: 0.05;
+    };
+    readonly pricing: "$0.05 per image, one input image a call";
+    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 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 "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: "call";
+      readonly usd: 0;
+    };
+    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.14;
+    };
+    readonly pricing: "$0.14/sec";
+    readonly queued: true;
+    readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
+    readonly task: "video background removal";
+  };
+  readonly "bria-video-rmbg-v3": {
+    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 Bria's VRMBG 3.0, with configurable output container.";
+    readonly endpoint: "bria/video/background-removal/v3";
+    readonly inputField: "video_url";
+    readonly inputKind: "video";
+    readonly name: "Bria Video Background Removal 3.0";
+    readonly outputKeys: ["video"];
+    readonly price: {
+      readonly kind: "second";
+      readonly usd: 0.05;
+    };
+    readonly pricing: "$0.05/sec";
+    readonly queued: true;
+    readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal/v3";
+    readonly task: "video background removal";
+  };
+  readonly "control-light": {
+    readonly category: "restoration";
+    readonly description: "Brighten a dark or underexposed photo, recovering detail while keeping its identity, geometry and colour.";
+    readonly endpoint: "fal-ai/control-light";
+    readonly inputField: "image_url";
+    readonly inputKind: "image";
+    readonly name: "Control Light";
+    readonly outputKeys: ["images"];
+    readonly price: {
+      readonly kind: "megapixel";
+      readonly usd: 0.03;
+    };
+    readonly pricing: "$0.03/megapixel";
+    readonly sourceUrl: "https://fal.ai/models/fal-ai/control-light";
+    readonly task: "low-light enhancement";
+  };
+  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: "call";
+      readonly usd: 0;
+    };
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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-step";
+      readonly megapixels: 2;
+      readonly usd: 0.08;
+    };
+    readonly pricing: "$0.08 per started 2 output megapixels, any Bloom model";
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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-step";
+      readonly megapixels: 8;
+      readonly usd: 0.08;
+    };
+    readonly pricing: "$0.08 per started 8 output megapixels at the default Wonder 3; per started 4 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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.48;
+    };
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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-step";
+      readonly megapixels: 24;
+      readonly usd: 0.08;
+    };
+    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 doubleAtFps: 60;
+      readonly halfWithModel: "Gaia 2";
+      readonly kind: "video-second";
+      readonly tiers: readonly [{
+        readonly upTo: 720;
+        readonly usd: 0.01;
+      }, {
+        readonly upTo: 1080;
+        readonly usd: 0.02;
+      }, {
+        readonly usd: 0.08;
+      }];
+    };
+    readonly pricing: "$0.01/sec up to 720p output; $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 "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 perImage: true;
+      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 extra: 0.015;
+      readonly first: 0.03;
+      readonly kind: "megapixel-first";
+    };
+    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 perImage: true;
+      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 fee: 0.05;
+      readonly kind: "call";
+      readonly multipliers: {
+        readonly resolution: {
+          readonly "4K": 2;
+        };
+      };
+      readonly per: readonly ["target_sizes", "num_images_per_size"];
+      readonly usd: 0.15;
+    };
+    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 "telestyle-v2": {
+    readonly category: "restyle";
+    readonly description: "Redraw a content image in the style of a second, style image.";
+    readonly endpoint: "fal-ai/telestyle-v2";
+    readonly inputField: "content_image_url";
+    readonly inputKind: "image";
+    readonly name: "TeleStyle v2";
+    readonly outputKeys: ["images"];
+    readonly price: {
+      readonly kind: "megapixel";
+      readonly usd: 0.035;
+    };
+    readonly pricing: "$0.035/megapixel";
+    readonly referenceField: "style_image_url";
+    readonly sourceUrl: "https://fal.ai/models/fal-ai/telestyle-v2";
+    readonly task: "style transfer from a reference image";
+  };
+  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 "virtual-try-on": {
+    readonly category: "try-on";
+    readonly description: "Dress the person in one image in the garment shown in another.";
+    readonly endpoint: "google/virtual-try-on";
+    readonly inputField: "person_image_url";
+    readonly inputKind: "image";
+    readonly name: "Google Virtual Try-On";
+    readonly outputKeys: ["images"];
+    readonly price: {
+      readonly kind: "call";
+      readonly perImage: true;
+      readonly usd: 0.075;
+    };
+    readonly pricing: "$0.075/image";
+    readonly queued: true;
+    readonly referenceField: "product_image_url";
+    readonly sourceUrl: "https://fal.ai/models/google/virtual-try-on";
+    readonly task: "virtual garment try-on";
+  };
+  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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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 frames: 16;
+      readonly kind: "frames";
+      readonly usd: 0.01;
+    };
+    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 frames: 16;
+      readonly kind: "frames";
+      readonly usd: 0.005;
+    };
+    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 frames: 16;
+      readonly kind: "frames";
+      readonly usd: 0.005;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    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: "call";
+      readonly usd: 0;
+    };
+    readonly pricing: "$0/compute-second listed by fal";
+    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
+    readonly task: "depth preprocessing";
+  };
+};
+declare const FAL_TOOL_IDS: (keyof typeof FAL_TOOLS)[];
+type FalToolId = (typeof FAL_TOOL_IDS)[number];
+export declare function isFalToolId(tool: string): tool is FalToolId;
+//#endregion
+export type { FalToolConfig, FalToolPrice, ModelConfig };