vidspotai-shared 1.0.124 → 1.0.125

package/lib/globals/aiModels/providers/runway.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runwayConfigs = void 0;
 const types_1 = require("../../../services/aiGen/providers/runway/types");
+/** Inclusive integer range, for per-second duration lists. */
+const range = (min, max) => Array.from({ length: max - min + 1 }, (_, i) => min + i);
 exports.runwayConfigs = {
     "runway-gen4.5": {
         modelId: "gen4.5",
@@ -25,9 +27,17 @@ exports.runwayConfigs = {
             publicFigureThreshold: { allowedValues: ["auto", "low"] },
             cameraControl: {},
         },
+        // 12 credits/s at $0.01/credit (Runway pricing page). Pro / HDR
+        // outputFormat surcharges aren't exposed, so plain mp4 is always billed.
         cost: {
             perSecond: 0.12,
         },
+        guidance: {
+            quality: 5,
+            speed: 3,
+            bestFor: "Runway's flagship: cinematic motion and physics, 2–10s clips, text or first-frame input",
+            notes: "No audio and no last frame. Text-to-video only renders 16:9 or 9:16; other ratios are coerced to the nearest of those.",
+        },
     },
     "runway-gen4-turbo": {
         modelId: "gen4_turbo",
@@ -44,7 +54,9 @@ exports.runwayConfigs = {
             duration: {
                 allowedValues: types_1.GEN4_TURBO_DURATIONS,
             }, // in seconds
-            lastFrameImageUrl: {}, // promptImage position:"last" for first-last interpolation
+            // REMOVED FOR v2 — kept for reference: the API only accepts
+            // promptImage position "first" for gen4_turbo, so first+last frames 400.
+            // lastFrameImageUrl: {}, // promptImage position:"last" for first-last interpolation
             seed: {},
             publicFigureThreshold: { allowedValues: ["auto", "low"] },
             cameraControl: {},
@@ -53,30 +65,72 @@ exports.runwayConfigs = {
         cost: {
             perSecond: 0.05,
         },
+        guidance: {
+            quality: 3,
+            speed: 4,
+            bestFor: "Cheap, fast image-to-video from a start frame, 2–10s",
+            notes: "Needs a start image; no text-only mode, no last frame, no audio.",
+        },
     },
+    // REMOVED FOR v2 — kept for reference: Runway retired gen4_aleph (it no
+    // longer appears among the video_to_video models) in favor of aleph2, which
+    // takes timed keyframes instead of references[] and costs 28 credits/s.
+    // "runway-gen4-aleph": {
+    //   modelId: "gen4_aleph",
+    //   type: ["video-to-video"],
+    //   tier: "T3",
+    //   fields: {
+    //     prompt: { required: true },
+    //     inputVideoUrl: { required: true },
+    //     aspectRatio: {
+    //       // Canonical ratios (validated against the incoming param). The service
+    //       // maps these → Runway pixel ratios (GEN4_ALEPH_RATIOS) at request time.
+    //       allowedValues: RUNWAY_VIDEO_CANONICAL_RATIOS,
+    //     },
+    //     duration: { allowedValues: GEN4_ALEPH_DURATIONS }, // in seconds
+    //     // Aleph references[] — image refs for character/style consistency. Runway
+    //     // caps Gen4 references at 3 per call.
+    //     referenceImageUrls: { max: 3 },
+    //     seed: {},
+    //     publicFigureThreshold: { allowedValues: ["auto", "low"] },
+    //     cameraControl: {},
+    //   },
+    //   // parallelRequests: 1,
+    //   cost: {
+    //     perSecond: 0.15,
+    //   },
+    // },
+    // Key kept so saved jobs / presets still resolve; it now serves Aleph 2.0.
     "runway-gen4-aleph": {
-        modelId: "gen4_aleph",
+        modelId: "aleph2",
         type: ["video-to-video"],
         tier: "T3",
         fields: {
-            prompt: { required: true },
-            inputVideoUrl: { required: true },
-            aspectRatio: {
-                // Canonical ratios (validated against the incoming param). The service
-                // maps these → Runway pixel ratios (GEN4_ALEPH_RATIOS) at request time.
-                allowedValues: types_1.RUNWAY_VIDEO_CANONICAL_RATIOS,
-            },
-            duration: { allowedValues: types_1.GEN4_ALEPH_DURATIONS }, // in seconds
-            // Aleph references[] — image refs for character/style consistency. Runway
-            // caps Gen4 references at 3 per call.
-            referenceImageUrls: { max: 3 },
+            // Optional on aleph2 — keyframes alone can drive the edit.
+            prompt: {},
+            inputVideoUrl: { required: true }, // at most 30s; output length matches it
+            // Not declared: aleph2's only ratio control is targetAspectRatio, which
+            // letterboxes and OUTPAINTS the input; output otherwise follows the
+            // source framing. Wire it only behind an explicit "expand to" control.
+            // aspectRatio: { allowedValues: ALEPH2_TARGET_ASPECT_RATIOS },
+            duration: { allowedValues: types_1.GEN4_ALEPH_DURATIONS }, // billing only; follows the input
+            // Sent as keyframes[] (max 5), spread evenly across the clip. Guidance
+            // images — typically an edited first frame the model propagates.
+            referenceImageUrls: { max: 5 },
             seed: {},
             publicFigureThreshold: { allowedValues: ["auto", "low"] },
             cameraControl: {},
         },
-        // parallelRequests: 1,
+        // 28 credits/s, 56-credit minimum per generation ($0.01/credit).
         cost: {
-            perSecond: 0.15,
+            perSecond: 0.28,
+            minimum: 0.56,
+        },
+        guidance: {
+            quality: 5,
+            speed: 2,
+            bestFor: "Editing an existing clip: restyle, relight, swap objects, change weather or angle",
+            notes: "Video in, video out (up to 30s, no audio generated). Billed per second of the input clip with a 2-second minimum.",
         },
     },
     // --- Image models ---
@@ -86,34 +140,406 @@ exports.runwayConfigs = {
         tier: "T2",
         fields: {
             prompt: { required: true },
+            // REMOVED FOR v2 — kept for reference: 768:1360 is not a Gen-4 Image
+            // ratio, so 3:4 requests 400'd.
+            // aspectRatio: {
+            //   allowedValues: ["1920:1080", "1080:1920", "1024:1024", "1360:768", "768:1360"],
+            // },
             aspectRatio: {
-                allowedValues: ["1920:1080", "1080:1920", "1024:1024", "1360:768", "768:1360"],
+                // Canonical ratios (what the dashboard / agent send) are mapped to
+                // pixel ratios by the service; raw pixel ratios pass straight through.
+                allowedValues: [
+                    ...types_1.GEN4_IMAGE_CANONICAL_RATIOS,
+                    ...types_1.GEN4_IMAGE_RATIOS_1080P,
+                    ...types_1.GEN4_IMAGE_RATIOS_720P,
+                ],
             },
             inputImageUrls: { max: 3 }, // referenceImages[] — up to 3 tagged refs
             seed: {},
+            publicFigureThreshold: { allowedValues: ["auto", "low"] },
         },
-        // Runway: $0.05 @ 720p tier, $0.08 @ 1080p tier. Square = 720p tier.
+        // Runway: 5 credits per 720p image, 8 per 1080p image. Canonical ratios
+        // map to the 1080p tier (see mapAspectToRunwayRatio).
+        // REMOVED FOR v2 — kept for reference:
+        // cost: {
+        //   perAspect: {
+        //     "1920:1080": 0.08, "1080:1920": 0.08,
+        //     "1360:768": 0.05, "768:1360": 0.05,
+        //     "1024:1024": 0.05,
+        //   },
+        //   fixed: 0.05, // fallback when aspect not supplied
+        // },
         cost: {
             perAspect: {
-                "1920:1080": 0.08, "1080:1920": 0.08,
-                "1360:768": 0.05, "768:1360": 0.05,
-                "1024:1024": 0.05,
+                ...Object.fromEntries(types_1.GEN4_IMAGE_RATIOS_1080P.map((r) => [r, 0.08])),
+                ...Object.fromEntries(types_1.GEN4_IMAGE_RATIOS_720P.map((r) => [r, 0.05])),
+                ...Object.fromEntries(types_1.GEN4_IMAGE_CANONICAL_RATIOS.map((r) => [r, 0.08])),
             },
-            fixed: 0.05, // fallback when aspect not supplied
+            fixed: 0.08, // no aspect → 1:1 → 1080:1080
+        },
+        guidance: {
+            quality: 4,
+            speed: 3,
+            bestFor: "Cinematic stills and character/object consistency from up to 3 tagged references",
+            notes: "Tag references in the prompt as @ref1..@ref3.",
         },
     },
     "runwayml-gen4-image-turbo": {
         modelId: "gen4_image_turbo",
-        type: ["text-to-image", "image-to-image"],
+        // REMOVED FOR v2 — kept for reference: no text-only mode (refs required).
+        // type: ["text-to-image", "image-to-image"],
+        type: ["image-to-image"],
         tier: "T1",
         fields: {
             prompt: { required: true },
             aspectRatio: {
-                allowedValues: ["1920:1080", "1080:1920", "1024:1024", "1360:768", "768:1360"],
+                // Canonical ratios (what the dashboard / agent send) are mapped to
+                // pixel ratios by the service; raw pixel ratios pass straight through.
+                allowedValues: [
+                    ...types_1.GEN4_IMAGE_CANONICAL_RATIOS,
+                    ...types_1.GEN4_IMAGE_RATIOS_1080P,
+                    ...types_1.GEN4_IMAGE_RATIOS_720P,
+                ],
             },
-            inputImageUrls: { max: 3 }, // referenceImages[] — up to 3 tagged refs
+            // Runway requires 1–3 referenceImages for gen4_image_turbo (min 1).
+            inputImageUrls: { max: 3, required: true },
             seed: {},
+            publicFigureThreshold: { allowedValues: ["auto", "low"] },
         },
         cost: { fixed: 0.02 },
+        guidance: {
+            quality: 3,
+            speed: 5,
+            bestFor: "Very cheap reference-driven edits and variations ($0.02, any resolution)",
+            notes: "Needs at least one reference image; it cannot generate from text alone.",
+        },
+    },
+    // ─── Third-party models hosted by Runway ─────────────────────────────────
+    // Same underlying models we also reach directly (BytePlus, Google, Alibaba,
+    // MiniMax, xAI), billed through our Runway account instead. Useful as a
+    // second route when a direct provider is down, rate-limited or geo-blocked,
+    // and for the few models we have no direct access to (Grok Imagine Video
+    // 1.5). Request vocabulary per model: services/aiGen/providers/runway/
+    // hostedModels.ts. Prices: docs.dev.runwayml.com/guides/pricing, fetched
+    // 2026-09-29, Runway credits at $0.01. `perSecondByResolution` is USD per
+    // output second; RunwayService.getCreditUsed adds the listed extras.
+    // Not wired: wan3_prime and gemini_omni_flash_1.1 (no published price yet).
+    "runway-wan3": {
+        modelId: "wan3",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["16:9", "9:16", "1:1", "4:3", "3:4"] },
+            resolution: { allowedValues: ["480p", "720p", "1080p"], default: "720p" },
+            duration: { allowedValues: range(2, 30) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            referenceImageUrls: { max: 10 },
+            referenceVideoUrls: { max: 5 },
+            referenceAudioUrls: { max: 5 },
+            audio: {},
+        },
+        // 5 / 10 / 20 credits per second; references not billed separately.
+        cost: { perSecondByResolution: { "480p": 0.05, "720p": 0.1, "1080p": 0.2 } },
+        guidance: {
+            quality: 4,
+            speed: 3,
+            bestFor: "Wan 3.0 through Runway: long (up to 30s) clips with image, video and audio references, first/last frames",
+            notes: "Same model as alibaba-wan-3.0 but with no input-video charge; no document or web-page references on this route.",
+        },
+    },
+    "runway-seedance2.5": {
+        modelId: "seedance2_5",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T3",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] },
+            resolution: { allowedValues: ["480p", "720p", "1080p"], default: "720p" },
+            duration: { allowedValues: range(4, 30) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            inputVideoUrl: {}, // promptVideo; endpoint "edit" → mode edit, else reference
+            referenceImageUrls: { max: 30 },
+            referenceVideoUrls: { max: 10 },
+            referenceAudioUrls: { max: 10 },
+            audio: {},
+            seed: {},
+        },
+        // 20 / 30 / 68 credits per output second, plus 10 / 15 / 34 per second of
+        // input + reference video (combined, capped at 30s); 80-credit minimum.
+        cost: {
+            perSecondByResolution: { "480p": 0.2, "720p": 0.3, "1080p": 0.68 },
+            inputVideoPerSecondByResolution: { "480p": 0.1, "720p": 0.15, "1080p": 0.34 },
+            inputVideoBillableMaxSec: 30,
+            minimum: 0.8,
+        },
+        guidance: {
+            quality: 5,
+            speed: 2,
+            bestFor: "Seedance 2.5 through Runway: fallback route for bytedance-seedance-2.5, incl. video reference/edit",
+            notes: "Priced above the direct BytePlus route; prefer bytedance-seedance-2.5 unless it is unavailable. 80-credit minimum per clip.",
+        },
+    },
+    "runway-seedance2": {
+        modelId: "seedance2",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T3",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] },
+            resolution: { allowedValues: ["480p", "720p", "1080p", "4k"], default: "720p" },
+            duration: { allowedValues: range(4, 15) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            inputVideoUrl: {},
+            referenceImageUrls: { max: 9 },
+            referenceVideoUrls: { max: 3 },
+            referenceAudioUrls: { max: 3 },
+            audio: {},
+            seed: {},
+        },
+        // 36 credits/s at 480p/720p, 40 at 1080p, 150 at 4K.
+        cost: { perSecondByResolution: { "480p": 0.36, "720p": 0.36, "1080p": 0.4, "4k": 1.5 } },
+        guidance: {
+            quality: 5,
+            speed: 2,
+            bestFor: "Seedance 2.0 through Runway, the only route to Seedance 2.0 at 4K",
+            notes: "Fallback for bytedance-seedance-2.0 otherwise. Reference images can't be mixed with first/last frames.",
+        },
+    },
+    "runway-seedance2-fast": {
+        modelId: "seedance2_fast",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] },
+            resolution: { allowedValues: ["480p", "720p"], default: "720p" },
+            duration: { allowedValues: range(4, 15) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            inputVideoUrl: {},
+            referenceImageUrls: { max: 9 },
+            referenceVideoUrls: { max: 3 },
+            referenceAudioUrls: { max: 3 },
+            audio: {},
+            seed: {},
+        },
+        cost: { perSecondByResolution: { "480p": 0.29, "720p": 0.29 } }, // 29 credits/s
+        guidance: {
+            quality: 4,
+            speed: 3,
+            bestFor: "Seedance 2.0 Fast through Runway: fallback for bytedance-seedance-2.0-fast",
+            notes: "480p/720p only.",
+        },
+    },
+    "runway-seedance2-mini": {
+        modelId: "seedance2_mini",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] },
+            resolution: { allowedValues: ["480p", "720p"], default: "720p" },
+            duration: { allowedValues: range(4, 15) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            inputVideoUrl: {},
+            referenceImageUrls: { max: 9 },
+            referenceVideoUrls: { max: 3 },
+            referenceAudioUrls: { max: 3 },
+            audio: {},
+            seed: {},
+        },
+        // 16 credits/s, 64-credit minimum per generation.
+        cost: { perSecondByResolution: { "480p": 0.16, "720p": 0.16 }, minimum: 0.64 },
+        guidance: {
+            quality: 3,
+            speed: 4,
+            bestFor: "Seedance 2.0 Mini through Runway: cheap Seedance route that needs no BytePlus activation",
+            notes: "480p/720p only; 64-credit minimum means clips under 4s cost the same as 4s.",
+        },
+    },
+    "runway-grok-imagine-1.5": {
+        modelId: "grok_imagine_1_5",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"] },
+            resolution: { allowedValues: ["480p", "720p", "1080p"], default: "720p" },
+            duration: { allowedValues: range(1, 15) },
+            inputImageUrl: {},
+            referenceImageUrls: { max: 7 }, // text-to-video only; cite as [Image 1]…
+            referenceAudioUrls: { max: 3 }, // needs ≥1 image reference
+        },
+        // 10 / 16 / 29 credits/s, plus 1 credit per image or audio reference
+        // (including a start frame). Verified 2026-09-29, docs.dev.runwayml.com/guides/pricing.
+        cost: {
+            perSecondByResolution: { "480p": 0.1, "720p": 0.16, "1080p": 0.29 },
+            perInputImage: 0.01,
+            perInputAudio: 0.01,
+        },
+        guidance: {
+            quality: 4,
+            speed: 4,
+            bestFor: "xAI Grok Imagine Video 1.5 (Runway-only route): 1–15s clips, up to 7 image references",
+            notes: "Image references cap output at 720p. Start-frame clips follow the image's aspect ratio.",
+        },
+    },
+    "runway-h3-max": {
+        modelId: "h3_max",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T1",
+        fields: {
+            prompt: { required: true },
+            resolution: { allowedValues: ["480p", "768p"], default: "768p" },
+            duration: { allowedValues: range(5, 15) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            promptOptimizer: {}, // → promptExpansionMode balanced / disabled
+            seed: {},
+        },
+        cost: { perSecondByResolution: { "480p": 0.05, "768p": 0.08 } }, // 5 / 8 credits/s
+        guidance: {
+            quality: 3,
+            speed: 3,
+            bestFor: "MiniMax H3 Max through Runway: cheapest 768p clips, no per-image or reference charges",
+            notes: "No aspect-ratio control and no references on this route (minimax-h3-max has them).",
+        },
+    },
+    "runway-hailuo3": {
+        modelId: "hailuo3",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] },
+            resolution: { allowedValues: ["768p", "2k"], default: "768p" },
+            duration: { allowedValues: range(5, 15) },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            inputVideoUrl: {},
+            referenceImageUrls: { max: 9 },
+            referenceVideoUrls: { max: 3 },
+            referenceAudioUrls: { max: 3 },
+        },
+        // 10 / 15 credits/s, plus 2 credits per reference image, plus reference
+        // video at the output rate (capped at 15s). Frames are counted as images
+        // too — at most 2 credits over.
+        cost: {
+            perSecondByResolution: { "768p": 0.1, "2k": 0.15 },
+            inputVideoPerSecondByResolution: { "768p": 0.1, "2k": 0.15 },
+            inputVideoBillableMaxSec: 15,
+            perInputImage: 0.02,
+        },
+        guidance: {
+            quality: 4,
+            speed: 3,
+            bestFor: "MiniMax Hailuo 3.0 (H3) through Runway: fallback for minimax-h3, incl. 2K and video references",
+            notes: "Reference images can't be mixed with first/last frames.",
+        },
+    },
+    "runway-veo3.1": {
+        modelId: "veo3.1",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T3",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["16:9", "9:16"] },
+            resolution: { allowedValues: ["720p", "1080p"], default: "720p" },
+            duration: { allowedValues: [4, 6, 8] },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            audio: {},
+            negativePrompt: {},
+            seed: {},
+        },
+        // 40 credits/s with audio, 20 without, at either resolution.
+        cost: {
+            perSecondByResolution: { "720p": 0.4, "1080p": 0.4 },
+            silentPerSecondByResolution: { "720p": 0.2, "1080p": 0.2 },
+        },
+        guidance: {
+            quality: 5,
+            speed: 2,
+            bestFor: "Veo 3.1 through Runway: fallback when Google's Veo quota (2–10 RPM) is exhausted",
+            notes: "Same price as google-veo-3.1; audio on by default and billed at double the silent rate.",
+        },
+    },
+    "runway-veo3.1-fast": {
+        modelId: "veo3.1_fast",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["16:9", "9:16"] },
+            resolution: { allowedValues: ["720p", "1080p"], default: "720p" },
+            duration: { allowedValues: [4, 6, 8] },
+            inputImageUrl: {},
+            lastFrameImageUrl: {},
+            audio: {},
+            negativePrompt: {},
+            seed: {},
+        },
+        cost: {
+            perSecondByResolution: { "720p": 0.15, "1080p": 0.15 },
+            silentPerSecondByResolution: { "720p": 0.1, "1080p": 0.1 },
+        },
+        guidance: {
+            quality: 4,
+            speed: 4,
+            bestFor: "Veo 3.1 Fast through Runway: fallback when Google's Veo quota is exhausted",
+            notes: "15 credits/s with audio, 10 without.",
+        },
+    },
+    "runway-happyhorse-1.0": {
+        modelId: "happyhorse_1_0",
+        type: ["text-to-video", "image-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["16:9", "9:16", "1:1", "4:3", "3:4"] },
+            resolution: { allowedValues: ["720p", "1080p"], default: "720p" },
+            duration: { allowedValues: range(3, 15) },
+            inputImageUrl: {},
+        },
+        cost: { perSecondByResolution: { "720p": 0.15, "1080p": 0.3 } }, // 15 / 30 credits/s
+        guidance: {
+            quality: 4,
+            speed: 3,
+            bestFor: "HappyHorse 1.0 through Runway: fallback for alibaba-happyhorse-1.0-t2v / -i2v",
+            notes: "Slightly pricier than the direct Alibaba route; no references or video edit here.",
+        },
+    },
+    "runway-gemini-omni-flash": {
+        modelId: "gemini_omni_flash",
+        type: ["text-to-video", "image-to-video", "video-to-video"],
+        tier: "T2",
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: ["16:9", "9:16"] },
+            resolution: { allowedValues: ["720p"], default: "720p" },
+            duration: { allowedValues: range(3, 10) },
+            inputImageUrl: {},
+            inputVideoUrl: {}, // edit: ≤10s, output length/orientation follow it
+            referenceImageUrls: { max: 5 }, // edit only
+        },
+        // 10 credits/s (+1 for a start frame); edits are 11 credits per INPUT
+        // second (capped at 10s) + 1 per reference image.
+        cost: {
+            perSecondByResolution: { "720p": 0.1 },
+            videoToVideoPerInputSecond: 0.11,
+            inputVideoBillableMaxSec: 10,
+            perInputImage: 0.01,
+        },
+        guidance: {
+            quality: 4,
+            speed: 4,
+            bestFor: "Gemini Omni Flash through Runway: 720p generation and instruction-based edits of short (≤10s) clips",
+            notes: "Fallback for google-gemini-omni-flash. Edits keep the input's length and orientation.",
+        },
     },
 };

package/lib/globals/aiModels/providers/xai.d.ts

@@ -0,0 +1,4 @@
+import { TAiGenModel } from "../enums";
+import { IModelSchema } from "../types";
+export declare const xaiConfigs: Partial<Record<TAiGenModel, IModelSchema>>;
+//# sourceMappingURL=xai.d.ts.map

package/lib/globals/aiModels/providers/xai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.d.ts","sourceRoot":"","sources":["../../../../src/globals/aiModels/providers/xai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAkBxC,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAsDjE,CAAC"}

package/lib/globals/aiModels/providers/xai.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xaiConfigs = void 0;
+// xAI Grok Imagine image models. Specs, prices and limits verified against
+// docs.x.ai on 2026-09-29: /developers/models/grok-imagine-image{,-2.0},
+// /developers/pricing (Imagine), /developers/rest-api-reference/inference/images,
+// /developers/model-capabilities/images/{generation,editing,multi-image-editing}.
+//
+// Both models: POST /v1/images/generations (T2I) and /v1/images/edits (JSON,
+// `image` or `images[]` up to 5), n 1–10, resolution 1k/2k, 6 requests/sec.
+// Pricing is flat per output image; edits are also billed per input image at
+// a rate xAI doesn't publish, so getCreditUsed counts each input like an
+// output (conservative) and the service logs xAI's `cost_in_usd_ticks` so the
+// estimate can be checked against the real charge.
+const XAI_IMAGE_ASPECTS_V1 = [
+    "1:1", "3:4", "4:3", "9:16", "16:9", "2:3", "3:2",
+    "9:19.5", "19.5:9", "9:20", "20:9", "1:2", "2:1",
+];
+exports.xaiConfigs = {
+    "xai-grok-imagine-image-2.0": {
+        modelId: "grok-imagine-image-2.0",
+        type: ["text-to-image", "image-to-image"],
+        tier: "T1",
+        acceptedImageFormats: ["image/jpeg", "image/jpg", "image/png", "image/webp"],
+        fields: {
+            prompt: { required: true },
+            // 2.0 adds 21:9 and 5:2 over 1.0.
+            aspectRatio: { allowedValues: [...XAI_IMAGE_ASPECTS_V1, "21:9", "5:2"] },
+            imageSize: { allowedValues: ["1k", "2k"], default: "1k" },
+            inputImageUrl: {},
+            inputImageUrls: { max: 5 },
+            numImages: { default: 1 },
+            // Only 2.0 takes `quality`. We pin "low" when unset: xAI's "auto" serves
+            // medium for edits and bills at the quality served.
+            quality: { allowedValues: ["low", "medium"], default: "low" },
+        },
+        requestPerMin: 360, // 6 RPS
+        cost: {
+            fixed: 0.04, // $0.04 / image at "low" (docs.x.ai pricing)
+            // "medium" isn't priced publicly ("billed at the quality served"); bill
+            // 2× until the logged cost_in_usd_ticks shows the real rate.
+            qualityMultiplier: { low: 1, medium: 2 },
+        },
+        guidance: {
+            quality: 5,
+            speed: 4,
+            bestFor: "Photoreal and stylized stills, text rendering, multi-image composites (up to 5 refs); #2 on Arena image edit at low quality.",
+            notes: "Replaces grok-imagine-image-quality (retired 2026-11-02).",
+        },
+    },
+    "xai-grok-imagine-image": {
+        modelId: "grok-imagine-image",
+        type: ["text-to-image", "image-to-image"],
+        tier: "T1",
+        acceptedImageFormats: ["image/jpeg", "image/jpg", "image/png", "image/webp"],
+        fields: {
+            prompt: { required: true },
+            aspectRatio: { allowedValues: XAI_IMAGE_ASPECTS_V1 },
+            imageSize: { allowedValues: ["1k", "2k"], default: "1k" },
+            inputImageUrl: {},
+            inputImageUrls: { max: 5 },
+            numImages: { default: 1 },
+        },
+        requestPerMin: 360,
+        cost: { fixed: 0.02 },
+        guidance: {
+            quality: 3,
+            speed: 5,
+            bestFor: "Cheap, fast drafts and bulk variations.",
+        },
+    },
+};

package/lib/globals/aiModels/tierHelpers.d.ts

@@ -8,12 +8,22 @@ export interface ModelMatch {
     modelKey: string;
     config: IModelSchema;
 }
+/** False for retired (shut down) and deprecated (still served, no longer
+ *  offered) models — the gate for every "which models can I pick" list. */
+export declare function isModelOffered(config: Pick<IModelSchema, "retired" | "deprecated"> | undefined): boolean;
 /** Return every model whose tier matches. Optionally filter by GenerationType. */
 export declare function getModelsByTier(tier: Tier, type?: GenerationType): ModelMatch[];
 /** Return the cheapest model satisfying (tier, type). Uses cost.fixed → cost.perSecond → 0. */
 export declare function getCheapestModel(tier: Tier, type: GenerationType): ModelMatch | undefined;
 /** Return all models supporting a generation type, regardless of tier. */
 export declare function getModelsByType(type: GenerationType): ModelMatch[];
+/**
+ * Representative USD/second for a model, covering the per-resolution shapes
+ * (`perSecondByResolution` — Alibaba/MiniMax; `perResolution` — Veo) as well
+ * as flat `perSecond`. Per-resolution rates use the model's default
+ * resolution, else the average across tiers. Undefined when not per-second.
+ */
+export declare function representativePerSecond(c: IModelSchema): number | undefined;
 /**
  * Build a compact, planner-readable summary of the model catalog grouped by
  * tier. Injected into the planner system prompt so the LLM can pick a concrete

package/lib/globals/aiModels/tierHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tierHelpers.d.ts","sourceRoot":"","sources":["../../../src/globals/aiModels/tierHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAc,YAAY,EAAE,MAAM,SAAS,CAAC;AAExE;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE,CAQ/E;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,cAAc,GACnB,UAAU,GAAG,SAAS,CAIxB;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAMlE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,GAAE,cAAgC,GACrC,MAAM,CAeR;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CASf;AA2DD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAU1E"}
+{"version":3,"file":"tierHelpers.d.ts","sourceRoot":"","sources":["../../../src/globals/aiModels/tierHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAc,YAAY,EAAE,MAAM,SAAS,CAAC;AAExE;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;2EAC2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG,SAAS,GAAG,OAAO,CAExG;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE,CAS/E;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,cAAc,GACnB,UAAU,GAAG,SAAS,CAIxB;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAc3E;AAWD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,GAAE,cAAgC,GACrC,MAAM,CAeR;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CASf;AA8DD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAU1E"}