@howells/motif-sdk 0.10.0 → 0.11.0

package/dist/image.d.ts

@@ -97,6 +97,12 @@ interface GenerateImageOptions {
     seed?: number;
     /** Abort signal to cancel the in-flight request. */
     signal?: AbortSignal;
+    /**
+     * Extra HTTP headers forwarded to the provider request. Fal's non-retained IO
+     * (paired with FalClient.deletePayloads) is
+     * `headers: { "X-Fal-Store-IO": "0" }`.
+     */
+    headers?: Record<string, string>;
     /**
      * Provider-specific options, passed straight through to the underlying model
      * as body parameters. Outer key = provider name, inner key = option name.
@@ -138,6 +144,12 @@ interface EditImageOptions {
     seed?: number;
     /** Abort signal to cancel the in-flight request. */
     signal?: AbortSignal;
+    /**
+     * Extra HTTP headers forwarded to the provider request. Fal's non-retained IO
+     * (paired with FalClient.deletePayloads) is
+     * `headers: { "X-Fal-Store-IO": "0" }`.
+     */
+    headers?: Record<string, string>;
     /** Provider-specific options (see {@link GenerateImageOptions.providerOptions}). */
     providerOptions?: Record<string, Record<string, unknown>>;
 }
@@ -368,7 +380,11 @@ declare const REPLICATE_API_KEY_ENV = "REPLICATE_API_TOKEN";
  *   });
  */
 
-/** Tier → fal model id. */
+/**
+ * Tier → fal model id. For fal, explicit `model:` endpoint ids are the primary
+ * path (any fal endpoint resolves via passthrough); this tier map is a
+ * convenience covering the two most common (FLUX Pro Ultra + gpt-image).
+ */
 declare const FAL_TIER_MODELS: Readonly<Record<ImageTier, string>>;
 /** Env var read for the fal key when `apiKey` is not supplied in config. */
 declare const FAL_API_KEY_ENV = "FAL_KEY";

package/dist/image.js

@@ -1291,8 +1291,58 @@ var FAL_TIER_MODELS = {
 };
 var FAL_API_KEY_ENV = "FAL_KEY";
 var FAL_IMAGE_PRICE_USD = {
+  // FLUX family.
   [FAL_FLUX_MODEL]: MODELS.flux?.pricePerImageUsd ?? 0.06,
-  [FAL_GPT_IMAGE_MODEL]: MODELS.gpt?.pricePerImageUsd ?? 0.133
+  // MODELS.flux
+  "fal-ai/flux/schnell": MODELS["flux-fast"]?.pricePerImageUsd ?? 3e-3,
+  // MODELS["flux-fast"]
+  // FLUX.2 family.
+  "fal-ai/flux-2-max": MODELS["flux2-max"]?.pricePerImageUsd ?? 0.07,
+  // MODELS["flux2-max"]
+  "fal-ai/flux-2-pro": MODELS["flux2-pro"]?.pricePerImageUsd ?? 0.03,
+  // MODELS["flux2-pro"]
+  "fal-ai/flux-2-flex": MODELS["flux2-flex"]?.pricePerImageUsd ?? 0.05,
+  // MODELS["flux2-flex"]
+  "fal-ai/flux-2": MODELS["flux2-dev"]?.pricePerImageUsd ?? 0.012,
+  // MODELS["flux2-dev"]
+  "fal-ai/flux-2/turbo": MODELS["flux2-turbo"]?.pricePerImageUsd ?? 8e-3,
+  // MODELS["flux2-turbo"]
+  // gpt-image (fal adds overhead vs OpenAI-direct — see design doc §10).
+  [FAL_GPT_IMAGE_MODEL]: MODELS.gpt?.pricePerImageUsd ?? 0.133,
+  // MODELS.gpt
+  "openai/gpt-image-2": MODELS.gpt2?.pricePerImageUsd ?? 0.211,
+  // MODELS.gpt2
+  // Nano Banana (Gemini image) family.
+  "fal-ai/nano-banana-2": MODELS.banana2?.pricePerImageUsd ?? 0.08,
+  // MODELS.banana2
+  "fal-ai/nano-banana-pro": MODELS.banana?.pricePerImageUsd ?? 0.15,
+  // MODELS.banana
+  "fal-ai/gemini-25-flash-image": MODELS.gemini?.pricePerImageUsd ?? 0.0398,
+  // MODELS.gemini
+  "fal-ai/gemini-3-pro-image-preview": MODELS.gemini3?.pricePerImageUsd ?? 0.15,
+  // MODELS.gemini3
+  // Seedream family.
+  "fal-ai/bytedance/seedream/v4/text-to-image": MODELS.seedream4?.pricePerImageUsd ?? 0.03,
+  // MODELS.seedream4
+  "fal-ai/bytedance/seedream/v4.5/text-to-image": MODELS.seedream45?.pricePerImageUsd ?? 0.04,
+  // MODELS.seedream45
+  "bytedance/seedream/v5/pro/text-to-image": MODELS.seedream5?.pricePerImageUsd ?? 0.0675,
+  // MODELS.seedream5
+  "fal-ai/bytedance/seedream/v5/lite/text-to-image": MODELS["seedream5-lite"]?.pricePerImageUsd ?? 0.035,
+  // MODELS["seedream5-lite"]
+  // Other priced fal generation endpoints.
+  "fal-ai/recraft-v3": MODELS.recraft?.pricePerImageUsd ?? 0.04,
+  // MODELS.recraft
+  "fal-ai/recraft/v4/text-to-image": MODELS.recraft4?.pricePerImageUsd ?? 0.04,
+  // MODELS.recraft4
+  "fal-ai/ideogram/v3": MODELS.ideogram?.pricePerImageUsd ?? 0.03,
+  // MODELS.ideogram
+  "ideogram/v4": MODELS.ideogram4?.pricePerImageUsd ?? 0.03,
+  // MODELS.ideogram4
+  "xai/grok-imagine-image": MODELS["grok-image"]?.pricePerImageUsd ?? 0.02,
+  // MODELS["grok-image"]
+  "fal-ai/qwen-image": MODELS.qwen?.pricePerImageUsd ?? 0.02
+  // MODELS.qwen
 };
 function resolveModel(modelId, apiKey) {
   const key = apiKey ?? process.env[FAL_API_KEY_ENV];
@@ -1505,6 +1555,7 @@ function createMotifImage(config = {}, deps = {}) {
         ...opts.aspectRatio === void 0 ? {} : { aspectRatio: opts.aspectRatio },
         ...opts.seed === void 0 ? {} : { seed: opts.seed },
         ...opts.signal === void 0 ? {} : { abortSignal: opts.signal },
+        ...opts.headers === void 0 ? {} : { headers: opts.headers },
         ...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
       });
       return ok2(toMotifImageResult(result, provider, modelId));
@@ -1527,6 +1578,7 @@ function createMotifImage(config = {}, deps = {}) {
         ...opts.n === void 0 ? {} : { n: opts.n },
         ...opts.seed === void 0 ? {} : { seed: opts.seed },
         ...opts.signal === void 0 ? {} : { abortSignal: opts.signal },
+        ...opts.headers === void 0 ? {} : { headers: opts.headers },
         ...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
       });
       return ok2(toMotifImageResult(result, provider, modelId));
@@ -1739,7 +1791,8 @@ function toMotifError(error) {
   }
   const message = error instanceof Error ? error.message : String(error);
   const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
-  return new MotifError(message, 0, code);
+  const status = error instanceof Error && "statusCode" in error && typeof error.statusCode === "number" ? error.statusCode : 0;
+  return new MotifError(message, status, code);
 }
 export {
   FAL_API_KEY_ENV,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/motif-sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Public Node SDK for Motif fal.ai generation, editing, utility tools, and model metadata.",
   "keywords": [
     "fal",