videobook 0.2.2 → 0.2.4

package/dist/media/catalog.js

@@ -8,6 +8,13 @@ const SEEDANCE_MODES = [
 const FRAME_MODES = [
     { id: "i2v", label: "Frames", roles: ["first_frame", "last_frame"] },
 ];
+const FLUX_3_MAX_DEFAULTS = {
+    aspect_ratio: "auto",
+    duration: 5,
+    generate_audio: true,
+    resolution: "720p",
+    reasoning_level: "high",
+};
 const SEEDANCE_US_REFERENCE_MODES = [
     { id: "r2v", label: "References", roles: ["image", "video", "audio"], requireAny: ["image", "video", "audio"] },
     { id: "v2v", label: "Edit video", roles: ["video", "image", "audio"], requireAny: ["video"], defaults: { task: "editing" } },
@@ -18,6 +25,20 @@ const XAI_MODES = [
     { id: "r2v", label: "References", roles: ["image"] },
     { id: "v2v", label: "Edit video", roles: ["video"], requireAny: ["video"] },
 ];
+const MACHGEN_FRAMES = { id: "i2v", label: "Frames", roles: ["first_frame", "last_frame"], requireAny: ["first_frame"] };
+const MACHGEN_MEDIA = ["image", "video", "audio"];
+function machgenModes(frames, references, requireAny = references) {
+    return [
+        { id: "t2v", label: "Text to video", roles: [] },
+        frames,
+        { id: "r2v", label: "References", roles: references, requireAny },
+    ];
+}
+function machgenClips(maximumSeconds) {
+    const window = { minimum: 2000, maximum: maximumSeconds * 1000, maximumTotal: maximumSeconds * 1000 };
+    return { refDurationMs: { video: window, audio: window } };
+}
+const MACHGEN_VIDEO = ["text_to_video", "image_to_video", "reference_to_video"];
 const SPEAKER = "Speaker 1";
 function kieGeminiClassicTts(id, title) {
     return {
@@ -110,6 +131,8 @@ export const MODEL_ENTRIES = [
     { id: "fal:ideogram/v4.5/edit", media: "image", operations: ["edit_image"], refs: { image: ["image_url", "reference_image_urls"] } },
     { id: "fal:blackforestlabs/flux-3/text-to-image", media: "image", operations: ["text_to_image"] },
     { id: "fal:blackforestlabs/flux-3/edit-image", media: "image", operations: ["edit_image"] },
+    { id: "fal:bria/fibo-2/generate", media: "image", operations: ["text_to_image"] },
+    { id: "fal:bria/fibo-2/edit", media: "image", operations: ["edit_image"], prompt: "instruction" },
     { id: "fal:fal-ai/flux-2-flex", media: "image", operations: ["text_to_image"] },
     { id: "fal:bria/guided-remove-background", media: "image", operations: ["edit_image"] },
     { id: "fal:bria/fibo-edit-1.5/expand", media: "image", operations: ["edit_image"] },
@@ -124,6 +147,14 @@ export const MODEL_ENTRIES = [
         defaults: { ...LIGHTNING_VIDEO_OPTIONS },
         frameOptions: { aspect_ratio: "adaptive" },
     },
+    {
+        id: "kie:bytedance/seedance-2-5-draft",
+        media: "video",
+        operations: ["upscale_video"],
+        title: "Seedance 2.5 Draft Complete",
+        description: "Render the 1080p final of a Seedance 2.5 draft: a 480p kie:bytedance/seedance-2-5 run with draft on. Pass that run's Kie task id as draft_task_id.",
+        defaults: { resolution: "1080p" },
+    },
     { id: "kie:grok-imagine/image-to-video", media: "video", operations: ["image_to_video"], guide: "grok_imagine" },
     { id: "kie:grok-imagine/text-to-video", media: "video", operations: ["text_to_video"], guide: "grok_imagine", defaults: { duration: 6, resolution: "480p" } },
     { id: "kie:grok-imagine/extend", media: "video", operations: ["extend_video"], hidden: true },
@@ -172,6 +203,10 @@ export const MODEL_ENTRIES = [
     { id: "fal:alibaba/wan-3.0-prime/text-to-video", media: "video", operations: ["text_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/image-to-video", media: "video", operations: ["image_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/reference-to-video", media: "video", operations: ["reference_to_video"], hidden: true },
+    { id: "fal:blackforestlabs/flux-3-max/text-to-video", media: "video", operations: ["text_to_video"], title: "FLUX 3 Max", defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:blackforestlabs/flux-3-max/image-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Image", refs: { first_frame: "image_url" }, modes: FRAME_MODES, defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:blackforestlabs/flux-3-max/keyframes-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Keyframes", refs: { image: "keyframes" }, keyframeFps: 24, defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:minimax/h3-max/reframe-video", media: "video", operations: ["edit_video"] },
     { id: "fal:minimax/h3-max/insert-video", media: "video", operations: ["edit_video"], refs: { video: ["video_url", "reference_video_urls"] } },
     { id: "fal:minimax/h3-max/recast", media: "video", operations: ["edit_video"] },
     { id: "fal:minimax/h3-max-turbo/extend-video", media: "video", operations: ["extend_video"] },
@@ -201,6 +236,54 @@ export const MODEL_ENTRIES = [
     { id: "fal:pixelcut/looping-video", media: "video", operations: ["image_to_video"], dialect: "strip_frames" },
     { id: "fal:creatify/boreal", media: "video", operations: ["text_to_video", "image_to_video", "lip_sync"] },
     { id: "fal:mirelo-ai/sfx2.0/video-to-video", media: "video", operations: ["edit_video"], prompt: "text_prompt", defaults: { num_samples: 1 } },
+    {
+        id: "machgen:MiniMax-H3",
+        media: "video",
+        operations: MACHGEN_VIDEO,
+        title: "MiniMax H3 (MachGen)",
+        dialect: "natural_strip_frames",
+        modes: machgenModes({ ...MACHGEN_FRAMES, requireAny: ["first_frame", "last_frame"] }, MACHGEN_MEDIA),
+        rules: machgenClips(15),
+    },
+    {
+        id: "machgen:Seedance-2.5",
+        media: "video",
+        operations: MACHGEN_VIDEO,
+        title: "Seedance 2.5 (MachGen)",
+        guide: "seedance25",
+        dialect: "natural_strip_frames",
+        modes: machgenModes(MACHGEN_FRAMES, MACHGEN_MEDIA),
+        frameOptions: { aspect_ratio: "adaptive" },
+        rules: machgenClips(30),
+    },
+    {
+        id: "machgen:Seedance-2.0",
+        media: "video",
+        operations: MACHGEN_VIDEO,
+        title: "Seedance 2.0 (MachGen)",
+        guide: "seedance2",
+        dialect: "natural_strip_frames",
+        modes: machgenModes(MACHGEN_FRAMES, MACHGEN_MEDIA, ["image", "video"]),
+        rules: machgenClips(15),
+    },
+    {
+        id: "machgen:Alibaba-Wan-3.0",
+        media: "video",
+        operations: MACHGEN_VIDEO,
+        title: "Wan 3.0 (MachGen)",
+        dialect: "natural_strip_frames",
+        modes: machgenModes(MACHGEN_FRAMES, MACHGEN_MEDIA),
+        rules: machgenClips(15),
+    },
+    {
+        id: "machgen:HappyHorse-1.1",
+        media: "video",
+        operations: MACHGEN_VIDEO,
+        title: "HappyHorse 1.1 (MachGen)",
+        dialect: "natural_strip_frames",
+        modes: machgenModes({ ...MACHGEN_FRAMES, roles: ["first_frame"] }, ["image"]),
+    },
+    { id: "machgen:Grok-Imagine-Video-1.5", media: "video", operations: ["image_to_video"], title: "Grok Imagine Video 1.5 (MachGen)", guide: "grok_imagine", dialect: "natural_strip_frames" },
     { id: "elevenlabs:text-to-speech", media: "audio", operations: ["speech"], title: "ElevenLabs Text to Speech", defaults: { model_id: "eleven_multilingual_v2" } },
     { id: "elevenlabs:sound-generation", media: "audio", operations: ["sfx"], title: "ElevenLabs Sound Effects" },
     { id: "elevenlabs:music", media: "audio", operations: ["music"], title: "ElevenLabs Music", defaults: { force_instrumental: true } },

package/dist/media/complete.js

@@ -36,7 +36,7 @@ function extensionFromContentType(contentType, media) {
 }
 async function download(output, media) {
     if ("bytes" in output)
-        return { bytes: output.bytes, extension: output.extension };
+        return { bytes: output.bytes, extension: output.extension, ...(output.url ? { url: output.url } : {}) };
     const response = await fetch(output.url);
     if (!response.ok)
         throw new Error(`Failed to download generated ${media}: ${response.status} ${response.statusText}`);

package/dist/media/cost.js

@@ -1,5 +1,70 @@
-import { computeEstimate } from "@apicity/cost";
+import { createFal } from "@apicity/fal";
+import { computeEstimate, createFalEstimateCache, resolveFalDynamicEstimate, } from "@apicity/cost";
 import { buildWireRequest } from "./request.js";
+const FAL_ESTIMATE_TTL_MS = 5 * 60 * 1000;
+let falEstimateCache = createFalEstimateCache({
+    ttlMs: FAL_ESTIMATE_TTL_MS,
+    maxEntries: 128,
+});
+let estimatorOverrideActive = false;
+let estimatorOverride = null;
+let liveEstimatorKey;
+let liveEstimator;
+function freshFalEstimateCache() {
+    return createFalEstimateCache({ ttlMs: FAL_ESTIMATE_TTL_MS, maxEntries: 128 });
+}
+export function installFalDynamicEstimator(estimator) {
+    const previous = {
+        active: estimatorOverrideActive,
+        estimator: estimatorOverride,
+        cache: falEstimateCache,
+    };
+    estimatorOverrideActive = true;
+    estimatorOverride = estimator;
+    falEstimateCache = freshFalEstimateCache();
+    return () => {
+        estimatorOverrideActive = previous.active;
+        estimatorOverride = previous.estimator;
+        falEstimateCache = previous.cache;
+    };
+}
+function falAdminKey() {
+    const value = process.env.FAL_ADMIN_API_KEY?.trim();
+    return value ? value : undefined;
+}
+function falPricingEstimator(apiKey) {
+    const estimate = createFal({ apiKey }).v1.models.pricing.estimate;
+    return (request) => estimate(request);
+}
+function currentFalEstimator() {
+    if (estimatorOverrideActive)
+        return estimatorOverride;
+    const apiKey = falAdminKey();
+    if (!apiKey)
+        return null;
+    if (liveEstimator && liveEstimatorKey === apiKey)
+        return liveEstimator;
+    liveEstimatorKey = apiKey;
+    liveEstimator = falPricingEstimator(apiKey);
+    return liveEstimator;
+}
+export async function estimateFalRequest(endpoint, payload, hints) {
+    const estimator = currentFalEstimator();
+    if (!estimator) {
+        return computeEstimate({
+            provider: "fal",
+            payload,
+            endpoint,
+            ...(hints ? { costHints: hints } : {}),
+        });
+    }
+    return resolveFalDynamicEstimate(endpoint, payload, estimator, {
+        ...(hints ? { hints } : {}),
+        // Queue polls omit x-fal-billable-units, so this is one historical call.
+        callQuantity: 1,
+        cache: falEstimateCache,
+    });
+}
 function costProvider(model) {
     return model.provider;
 }
@@ -24,20 +89,28 @@ export function generationCostHints(input, hints) {
         ? { ...combined, durationSeconds: combined.inputDurationSeconds }
         : combined;
 }
-function estimateWireRequest(model, request, input, hints = {}) {
+async function estimateWireRequest(model, request, input, hints = {}) {
+    const payload = costPayload(model, request, input);
+    const costHints = generationCostHints(input, hints);
+    if (model.provider === "fal")
+        return estimateFalRequest(model.apiId, payload, costHints);
     return computeEstimate({
         provider: costProvider(model),
-        payload: costPayload(model, request, input),
+        payload,
         endpoint: model.apiId,
-        costHints: generationCostHints(input, hints),
+        costHints,
     });
 }
-export function estimateGeneration(model, call, hints = {}) {
+export async function estimateGeneration(model, call, hints = {}) {
     const built = buildWireRequest(model, call);
     if (!built.ok)
         return built;
     try {
-        return { ok: true, estimate: estimateWireRequest(model, built.request, built.input, hints), request: built.request };
+        return {
+            ok: true,
+            estimate: await estimateWireRequest(model, built.request, built.input, hints),
+            request: built.request,
+        };
     }
     catch (error) {
         return { ok: false, error: error instanceof Error ? error.message : String(error) };

package/dist/media/frontier-gaps.js

@@ -0,0 +1,49 @@
+export const FRONTIER_CATALOG_GAPS = {
+    "fal:openai.gptImage2p5.sunburst.textToImage": "This exact endpoint is not in the Videobook catalog.",
+    "fal:openai.gptImage2p5.flare.textToImage": "This exact endpoint is not in the Videobook catalog.",
+    "kie:gpt-image-2-text-to-image": "This exact endpoint is not in the Videobook catalog.",
+    "fal:xai.grokImagineImage.v2p0.textToImage": "This exact endpoint is not in the Videobook catalog.",
+    "kie:grok-imagine-image-2-0/text-to-image": "This exact endpoint is not in the Videobook catalog.",
+    "kie:nano-banana-2": "This exact endpoint is not in the Videobook catalog.",
+    "googleflow:nano-banana-2": "Google Flow is not a catalog provider.",
+    "fal:meta.museImage.textToImage": "This exact endpoint is not in the Videobook catalog.",
+    "kie:gpt-image/1.5-text-to-image": "This exact endpoint is not in the Videobook catalog.",
+    "fal:openai.gptImage2p5.sunburst.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:openai.gptImage2p5.flare.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedream.v5.pro.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:meta.museImage.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:microsoft.maiImage2p5Pro.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p5.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3Max.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3MaxTurbo.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:blackforestlabs.flux3.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p0.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "kie:bytedance/seedance-2": "This exact endpoint is not in the Videobook catalog.",
+    "fal:geminiOmniFlash.v1p1.textToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "kie:google/gemini-omni-flash-1-1": "This exact endpoint is not in the Videobook catalog.",
+    "googleflow:omni-flash": "Google Flow is not a catalog provider.",
+    "fal:minimax.h3.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p5.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:geminiOmniFlash.v1p1.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3Max.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3MaxTurbo.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p0.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:blackforestlabs.flux3.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:xai.grokImagineVideo.v1p5.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "kie:grok-imagine-video-1-5-preview": "This exact endpoint is not in the Videobook catalog.",
+    "xai:v1.videos.generations.imageToVideo": "The catalog uses grok-imagine-video, not the ranked 1.5 model id.",
+    "fal:alibaba.happyHorse.v1p1.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p5.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:geminiOmniFlash.v1p1.edit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:wan.v2p7.editVideo": "This exact endpoint is not in the Videobook catalog.",
+    "kie:wan/2-7-videoedit": "This exact endpoint is not in the Videobook catalog.",
+    "alibaba:wan2.7-videoedit": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:minimax.h3Max.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:bytedance.seedance2p0.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:geminiOmniFlash.v1p1.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "fal:xai.grokImagineVideo.v1p5.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",
+    "xai:grok-imagine-video-1.5": "The catalog uses grok-imagine-video, not the ranked 1.5 model id.",
+    "fal:alibaba.happyHorse.v1p1.referenceToVideo": "This exact endpoint is not in the Videobook catalog."
+};

package/dist/media/frontier.js

@@ -0,0 +1,30 @@
+import { FRONTIER, FRONTIER_TYPES, formatFrontierPrice, frontier } from "@apicity/cost";
+import { MODEL_ENTRIES } from "./catalog.js";
+export function frontierCatalogId(row) {
+    const endpoint = FRONTIER[row.type].entries.find((entry) => entry.rank === row.rank && entry.model === row.model)?.endpoints
+        .find((endpoint) => endpoint.provider === row.provider && endpoint.dotPath === row.dotPath && endpoint.modelId === row.modelId);
+    const apiId = row.modelId ?? (row.provider === "fal" ? endpoint?.pricingKey : undefined);
+    return apiId && apiId !== "unpriced" ? `${row.provider}:${apiId}` : null;
+}
+const rankings = new Map();
+for (const { type } of FRONTIER_TYPES) {
+    for (const row of frontier(type)) {
+        const id = frontierCatalogId(row);
+        if (!id || !MODEL_ENTRIES.some((entry) => entry.id === id))
+            continue;
+        const previous = rankings.get(id) ?? [];
+        if (previous.some((entry) => entry.type === type))
+            continue;
+        rankings.set(id, [...previous, {
+                type,
+                rank: row.rank,
+                elo: row.elo,
+                priceLabel: formatFrontierPrice(row.price),
+                sourceUrl: FRONTIER[type].sourceUrl,
+                capturedOn: FRONTIER[type].capturedOn,
+            }]);
+    }
+}
+export function modelFrontierRankings(id) {
+    return rankings.get(id) ?? [];
+}

package/dist/media/json-schema.js

@@ -36,6 +36,13 @@ export function isUrlObject(schema) {
         return false;
     return branches(schema).some((branch) => branch.type === "object" && branch.properties?.url !== undefined);
 }
+export function isKeyframeItem(schema) {
+    if (!schema)
+        return false;
+    return branches(schema).some((branch) => branch.type === "object"
+        && branch.properties?.image_url !== undefined
+        && branch.properties?.frame_index !== undefined);
+}
 export function isArraySchema(schema) {
     return branches(schema).some((branch) => branch.type === "array");
 }

package/dist/media/listing.js

@@ -1,5 +1,10 @@
+import { modelFrontierRankings } from "./frontier.js";
+import { PROVIDER_ENV_KEYS } from "./adapters/index.js";
 import { MODEL_ENTRIES } from "./catalog.js";
 import { resolveModel } from "./descriptor.js";
+export function modelIsHidden(entry) {
+    return entry.hidden === true && modelFrontierRankings(entry.id).length === 0;
+}
 export function modelListing(model) {
     return {
         id: model.id,
@@ -12,12 +17,14 @@ export function modelListing(model) {
         refs: model.slots.map(({ role, min, max }) => ({ role, min, max })),
         modes: model.modes,
         options: model.options,
-        hidden: model.entry.hidden === true,
+        hidden: modelIsHidden(model.entry),
+        available: Boolean(process.env[PROVIDER_ENV_KEYS[model.provider]]?.trim()),
+        frontier: modelFrontierRankings(model.id),
     };
 }
 export function listModels(filter = {}) {
     return MODEL_ENTRIES
-        .filter((entry) => filter.includeHidden || !entry.hidden)
+        .filter((entry) => filter.includeHidden || !modelIsHidden(entry))
         .filter((entry) => !filter.media || entry.media === filter.media)
         .filter((entry) => !filter.operation || entry.operations.includes(filter.operation))
         .map((entry) => resolveModel(entry.id));

package/dist/media/machgen.js

@@ -0,0 +1,261 @@
+import { z } from "zod";
+import { MachGenGenerateRequestSchema } from "@apicity/machgen/zod";
+const DEFAULT_DURATION_SECONDS = 5;
+const SEEDANCE_ASPECT_RATIOS = ["adaptive", "21:9", "16:9", "9:16", "1:1", "4:3", "3:4"];
+const ALL_REFERENCES = ["image", "video", "audio"];
+export const MACHGEN_MODELS = {
+    "MiniMax-H3": {
+        taskTypes: ["T2V", "I2V", "R2V"],
+        resolutions: { "480p": 480, "768p": 768, "1440p": 1440 },
+        defaultResolution: "768p",
+        durations: { min: 1, max: 30, smart: false },
+        aspectRatios: ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"],
+        audioToggle: true,
+        seed: true,
+        lastFrame: "alone",
+        references: ALL_REFERENCES,
+        visualReference: false,
+        promptRequiredFor: ["T2V", "I2V", "R2V"],
+        maxPromptChars: 65535,
+        maxSecondsWithBothFrames: 15,
+        maxSecondsAt: { "1440p": 15 },
+    },
+    "Seedance-2.5": {
+        taskTypes: ["T2V", "I2V", "R2V"],
+        resolutions: { "480p": 480, "720p": 720, "1080p": 1080 },
+        defaultResolution: "720p",
+        durations: { min: 4, max: 30, smart: true },
+        aspectRatios: SEEDANCE_ASPECT_RATIOS,
+        audioToggle: true,
+        seed: false,
+        lastFrame: "with_first",
+        references: ALL_REFERENCES,
+        visualReference: false,
+        promptRequiredFor: ["T2V", "R2V"],
+        maxPromptChars: 25000,
+        smartEditNeedsAdaptive: true,
+    },
+    "Seedance-2.0": {
+        taskTypes: ["T2V", "I2V", "R2V"],
+        resolutions: { "480p": 480, "720p": 720, "1080p": 1080, "2160p": 2160 },
+        defaultResolution: "720p",
+        durations: { min: 4, max: 15, smart: true },
+        aspectRatios: SEEDANCE_ASPECT_RATIOS,
+        audioToggle: true,
+        seed: true,
+        lastFrame: "with_first",
+        references: ALL_REFERENCES,
+        visualReference: true,
+        promptRequiredFor: ["T2V"],
+    },
+    "Alibaba-Wan-3.0": {
+        taskTypes: ["T2V", "I2V", "R2V"],
+        resolutions: { "480p": 480, "720p": 720, "1080p": 1080 },
+        defaultResolution: "720p",
+        durations: { min: 2, max: 30, smart: true },
+        aspectRatios: [],
+        videoConfig: { aspect_ratio: "adaptive", fps: 30, audio: true },
+        audioToggle: false,
+        seed: true,
+        lastFrame: "with_first",
+        references: ALL_REFERENCES,
+        visualReference: false,
+        promptRequiredFor: ["T2V"],
+    },
+    "HappyHorse-1.1": {
+        taskTypes: ["T2V", "I2V", "R2V"],
+        resolutions: { "720p": 720, "1080p": 1080 },
+        defaultResolution: "720p",
+        durations: { min: 3, max: 15, smart: false },
+        aspectRatios: ["16:9", "9:16", "1:1", "4:3", "21:9"],
+        framesFollowImage: true,
+        audioToggle: false,
+        seed: true,
+        lastFrame: "none",
+        references: ["image"],
+        visualReference: true,
+        promptRequiredFor: ["T2V"],
+    },
+    "Grok-Imagine-Video-1.5": {
+        taskTypes: ["I2V"],
+        resolutions: { "480p": 480, "720p": 720, "1080p": 1080 },
+        defaultResolution: "720p",
+        durations: { min: 1, max: 15, smart: false },
+        aspectRatios: [],
+        audioToggle: false,
+        seed: false,
+        lastFrame: "none",
+        references: [],
+        visualReference: true,
+        promptRequiredFor: [],
+    },
+};
+const REFERENCE_FIELDS = {
+    image: "reference_image_urls",
+    video: "reference_video_urls",
+    audio: "reference_audio_urls",
+};
+const SOURCE_FIELDS = {
+    image: "src_image_urls",
+    video: "src_video_urls",
+    audio: "src_audio_urls",
+};
+function text(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : null;
+}
+function list(value) {
+    return Array.isArray(value) ? value.filter((item) => text(item) !== null) : [];
+}
+function referencesOf(spec, value) {
+    const found = { image: [], video: [], audio: [] };
+    for (const kind of spec.references)
+        found[kind] = list(value[REFERENCE_FIELDS[kind]]);
+    return found;
+}
+function hasFrames(value) {
+    return text(value.first_frame_url) !== null || text(value.last_frame_url) !== null;
+}
+function taskTypeOf(spec, value) {
+    if (hasFrames(value))
+        return "I2V";
+    const references = referencesOf(spec, value);
+    return ALL_REFERENCES.some((kind) => references[kind].length > 0) ? "R2V" : "T2V";
+}
+function promptField(spec) {
+    const prompt = spec.maxPromptChars === undefined ? z.string() : z.string().max(spec.maxPromptChars);
+    return spec.taskTypes.every((task) => spec.promptRequiredFor.includes(task)) ? prompt.min(1) : prompt.optional();
+}
+function durationField(spec) {
+    const { min, max, smart } = spec.durations;
+    const seconds = z.number().int().min(min).max(max);
+    return (smart ? z.union([z.literal(-1), seconds]) : seconds)
+        .default(DEFAULT_DURATION_SECONDS)
+        .describe(smart ? `Seconds (${min}-${max}); -1 lets the model choose the length` : `Seconds (${min}-${max})`);
+}
+function frameFields(spec) {
+    if (!spec.taskTypes.includes("I2V"))
+        return {};
+    const first = z.string().min(1);
+    return {
+        first_frame_url: spec.taskTypes.length === 1 ? first : first.optional(),
+        ...(spec.lastFrame === "none" ? {} : { last_frame_url: z.string().min(1).optional() }),
+    };
+}
+function referenceFields(spec) {
+    const source = MachGenGenerateRequestSchema.shape;
+    return Object.fromEntries(spec.references.map((kind) => [REFERENCE_FIELDS[kind], source[SOURCE_FIELDS[kind]]]));
+}
+function settingFields(spec) {
+    const [firstAspect, ...otherAspects] = spec.aspectRatios;
+    return {
+        duration: durationField(spec),
+        resolution: z.enum(Object.keys(spec.resolutions))
+            .default(spec.defaultResolution)
+            .describe("Output resolution"),
+        ...(firstAspect === undefined ? {} : {
+            aspect_ratio: z.enum([firstAspect, ...otherAspects]).default(firstAspect).describe("Output aspect ratio"),
+        }),
+        ...(spec.audioToggle ? { generate_audio: z.boolean().default(true).describe("Generate a soundtrack with the video") } : {}),
+        ...(spec.seed ? { seed: z.number().int().min(0).max(2_147_483_647).optional().describe("Seed for reproducible output") } : {}),
+    };
+}
+function addIssue(ctx, path, message) {
+    ctx.addIssue({ code: "custom", message, path: path ? [path] : [] });
+}
+function checkFrames(spec, value, ctx) {
+    if (!hasFrames(value))
+        return;
+    const references = referencesOf(spec, value);
+    for (const kind of ALL_REFERENCES) {
+        if (references[kind].length > 0)
+            addIssue(ctx, REFERENCE_FIELDS[kind], "cannot be combined with first_frame_url or last_frame_url");
+    }
+    if (text(value.first_frame_url) === null && spec.lastFrame !== "alone")
+        addIssue(ctx, "last_frame_url", "last_frame_url requires first_frame_url");
+    const both = text(value.first_frame_url) !== null && text(value.last_frame_url) !== null;
+    const limit = spec.maxSecondsWithBothFrames;
+    if (both && limit !== undefined && typeof value.duration === "number" && value.duration > limit) {
+        addIssue(ctx, "duration", `a first and last frame allow at most ${limit} seconds`);
+    }
+}
+function checkReferences(spec, value, task, ctx) {
+    if (task !== "R2V")
+        return;
+    const references = referencesOf(spec, value);
+    if (spec.visualReference && references.image.length === 0 && references.video.length === 0) {
+        addIssue(ctx, "", "reference-to-video needs at least one reference image or video");
+    }
+    if (spec.smartEditNeedsAdaptive && value.duration === -1 && references.video.length > 0 && value.aspect_ratio !== "adaptive") {
+        addIssue(ctx, "aspect_ratio", "-1 duration with a reference video edits that video and needs the adaptive aspect ratio");
+    }
+}
+function checkSettings(spec, value, task, ctx) {
+    if (!spec.taskTypes.includes(task))
+        addIssue(ctx, "", `${task} is not supported; use ${spec.taskTypes.join(", ")}`);
+    if (spec.promptRequiredFor.includes(task) && text(value.prompt) === null)
+        addIssue(ctx, "prompt", "Required");
+    const limit = typeof value.resolution === "string" ? spec.maxSecondsAt?.[value.resolution] : undefined;
+    if (limit !== undefined && typeof value.duration === "number" && value.duration > limit) {
+        addIssue(ctx, "duration", `${String(value.resolution)} allows at most ${limit} seconds`);
+    }
+}
+function machgenInput(spec) {
+    return z.object({
+        prompt: promptField(spec),
+        ...frameFields(spec),
+        ...referenceFields(spec),
+        ...settingFields(spec),
+    }).superRefine((value, ctx) => {
+        const record = value;
+        const task = taskTypeOf(spec, record);
+        checkSettings(spec, record, task, ctx);
+        checkFrames(spec, record, ctx);
+        checkReferences(spec, record, task, ctx);
+    });
+}
+function frameSources(value) {
+    const first = text(value.first_frame_url);
+    const last = text(value.last_frame_url);
+    if (first === null && last !== null)
+        return { src_image_urls: [last], keyframe_indices: [-1] };
+    return { src_image_urls: [first, last].filter((url) => url !== null) };
+}
+function referenceSources(spec, value) {
+    const references = referencesOf(spec, value);
+    return Object.fromEntries(ALL_REFERENCES
+        .filter((kind) => references[kind].length > 0)
+        .map((kind) => [SOURCE_FIELDS[kind], references[kind]]));
+}
+function videoConfig(spec, value, task) {
+    const aspect = text(value.aspect_ratio);
+    return {
+        height: spec.resolutions[String(value.resolution)],
+        duration_secs: value.duration,
+        ...(aspect !== null && !(task === "I2V" && spec.framesFollowImage) ? { aspect_ratio: aspect } : {}),
+        ...(typeof value.generate_audio === "boolean" ? { audio: value.generate_audio } : {}),
+        ...spec.videoConfig,
+    };
+}
+function machgenRequest(apiId, spec, value) {
+    const task = taskTypeOf(spec, value);
+    return {
+        model: apiId,
+        task_type: task,
+        prompt: typeof value.prompt === "string" ? value.prompt : "",
+        video_config: videoConfig(spec, value, task),
+        ...(typeof value.seed === "number" ? { seed: value.seed } : {}),
+        ...(task === "I2V" ? frameSources(value) : {}),
+        ...(task === "R2V" ? referenceSources(spec, value) : {}),
+    };
+}
+export function machgenWire(apiId) {
+    const spec = MACHGEN_MODELS[apiId];
+    if (!spec)
+        return null;
+    return {
+        input: machgenInput(spec),
+        fixed: {},
+        wrap: (value) => machgenRequest(apiId, spec, value),
+        request: MachGenGenerateRequestSchema,
+    };
+}

package/dist/media/model-id.js

@@ -1,4 +1,4 @@
-const PROVIDERS = ["kie", "fal", "xai", "alibaba", "elevenlabs"];
+const PROVIDERS = ["kie", "fal", "xai", "alibaba", "elevenlabs", "machgen"];
 function isProvider(value) {
     return PROVIDERS.includes(value);
 }

package/dist/media/preview.js

@@ -27,6 +27,8 @@ function providerPath(model) {
             return "alibaba.post.api.v1.services.aigc.multimodalGeneration.generation(request)";
         case "elevenlabs":
             return ELEVENLABS_PATHS[model.apiId] ?? "elevenlabs";
+        case "machgen":
+            return "machgen.api.v0.generate(request)";
     }
 }
 function placeholderRefs(refs) {

package/dist/media/prompt-dialects.js

@@ -43,6 +43,8 @@ function rewrite(dialect, prompt, refs) {
             return natural(prompt, refs).replace(/@image([1-9]\d*)\b/giu, "reference image $1");
         case "natural_kinds":
             return natural(prompt, refs).replace(/@(image|audio)([1-9]\d*)(?![\w-])/giu, (_match, kind, index) => `reference ${kind.toLowerCase()} ${index}`);
+        case "natural_strip_frames":
+            return stripRefMentions(natural(prompt, refs), frames(refs));
         case "natural_source_video":
             return replaceNaturalAssetMentions(prompt, {
                 imageRefs: refsFor(refs, "image"),