mulmocast 2.6.5 → 2.6.7

package/lib/types/provider2agent.js

@@ -92,6 +92,9 @@ export const provider2MovieAgent = {
             "kwaivgi/kling-v2.1-master",
             "google/veo-2",
             "google/veo-3",
+            "google/veo-3.1",
+            "google/veo-3.1-fast",
+            "google/veo-3.1-lite",
             "google/veo-3-fast",
             "minimax/video-01",
             "minimax/hailuo-02",
@@ -99,6 +102,11 @@ export const provider2MovieAgent = {
             "pixverse/pixverse-v4.5",
             "wan-video/wan-2.2-i2v-fast",
             "wan-video/wan-2.2-t2v-fast",
+            "xai/grok-imagine-video",
+            "xai/grok-imagine-r2v",
+            "runwayml/gen-4.5",
+            "kwaivgi/kling-v3-omni-video",
+            "kwaivgi/kling-v3-video",
         ],
         modelParams: {
             "bytedance/seedance-1-lite": {
@@ -138,6 +146,25 @@ export const provider2MovieAgent = {
                 start_image: "image",
                 price_per_sec: 0.75,
             },
+            "google/veo-3.1": {
+                durations: [4, 6, 8],
+                start_image: "image",
+                last_image: "last_frame_image",
+                reference_images_param: "reference_images",
+                price_per_sec: 0.75,
+            },
+            "google/veo-3.1-fast": {
+                durations: [4, 6, 8],
+                start_image: "image",
+                last_image: "last_frame_image",
+                price_per_sec: 0.4,
+            },
+            "google/veo-3.1-lite": {
+                durations: [4, 6, 8],
+                start_image: "image",
+                last_image: "last_frame",
+                price_per_sec: 0.05,
+            },
             "google/veo-3-fast": {
                 durations: [8],
                 start_image: "image",
@@ -175,28 +202,68 @@ export const provider2MovieAgent = {
                 start_image: undefined,
                 price_per_sec: 0.012,
             },
+            "xai/grok-imagine-video": {
+                durations: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+                start_image: "image",
+                price_per_sec: 0.08,
+            },
+            "xai/grok-imagine-r2v": {
+                durations: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
+                start_image: undefined,
+                reference_images_param: "reference_images",
+                price_per_sec: 0.08,
+            },
+            "runwayml/gen-4.5": {
+                durations: [5, 10],
+                start_image: "image",
+                price_per_sec: 0.25,
+            },
+            "kwaivgi/kling-v3-omni-video": {
+                durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+                start_image: "start_image",
+                last_image: "end_image",
+                reference_images_param: "reference_images",
+                price_per_sec: 0.3,
+            },
+            "kwaivgi/kling-v3-video": {
+                durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+                start_image: "start_image",
+                last_image: "end_image",
+                reference_images_param: "reference_images",
+                price_per_sec: 0.3,
+            },
         },
     },
     google: {
         agentName: "movieGenAIAgent",
         defaultModel: "veo-2.0-generate-001",
-        models: ["veo-2.0-generate-001", "veo-3.0-generate-001", "veo-3.1-generate-preview"],
+        models: ["veo-2.0-generate-001", "veo-3.0-generate-001", "veo-3.1-generate-preview", "veo-3.1-lite-generate-preview"],
         keyName: "GEMINI_API_KEY",
         modelParams: {
+            "veo-3.1-lite-generate-preview": {
+                durations: [4, 6, 8],
+                supportsDuration: true,
+                supportsLastFrame: true,
+                supportsReferenceImages: false,
+                supportsPersonGeneration: false,
+            },
             "veo-3.1-generate-preview": {
                 durations: [4, 6, 8],
+                supportsDuration: true,
                 supportsLastFrame: true,
                 supportsReferenceImages: true,
                 supportsPersonGeneration: false,
             },
             "veo-3.0-generate-001": {
-                durations: [4, 6, 8],
+                durations: [8],
+                supportsDuration: false, // Veo 3.0 always generates 8s
                 supportsLastFrame: false,
                 supportsReferenceImages: false,
                 supportsPersonGeneration: false,
             },
             "veo-2.0-generate-001": {
-                durations: [5, 6, 7, 8],
+                durations: [5, 6, 8],
+                supportsDuration: true,
                 supportsLastFrame: false, // Vertex AI only
                 supportsReferenceImages: false,
                 supportsPersonGeneration: true,
@@ -229,7 +296,7 @@ export const provider2LipSyncAgent = {
         agentName: "lipSyncReplicateAgent",
         defaultModel: "bytedance/omni-human",
         keyName: "REPLICATE_API_TOKEN",
-        models: ["bytedance/latentsync", "tmappdev/lipsync", "bytedance/omni-human"],
+        models: ["bytedance/latentsync", "tmappdev/lipsync", "bytedance/omni-human", "pixverse/lipsync"],
         modelParams: {
             "bytedance/latentsync": {
                 identifier: "bytedance/latentsync:637ce1919f807ca20da3a448ddc2743535d2853649574cd52a933120e9b9e293",
@@ -247,14 +314,20 @@ export const provider2LipSyncAgent = {
                 audio: "audio",
                 price_per_sec: 0.14,
             },
+            "pixverse/lipsync": {
+                identifier: "pixverse/lipsync:3ca6d73f4fb9e1d77a4b6e14f8998ee18926e4dc462838e31fa2bb5e662c1e2c",
+                video: "video",
+                audio: "audio",
+            },
             /* NOTE: This model does not work with large base64 urls.
             "sync/lipsync-2": {
               video: "video",
               audio: "audio",
             },
             */
-            /* NOTE: This model does not work well for some unknown reason.
+            /* NOTE: This model does not work with base64 data URIs (error 1201).
             "kwaivgi/kling-lip-sync": {
+              identifier: "kwaivgi/kling-lip-sync:8311467f07043d4b3feb44584d2586bfa2fc70203eca612ed26f84d0b55df3ce",
               video: "video_url",
               audio: "audio_file",
             },

package/lib/types/schema.d.ts

@@ -3299,6 +3299,7 @@ export declare const mulmoImageParamsSchema: z.ZodObject<{
         }>>;
         opacity: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>]>>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const textSlideParamsSchema: z.ZodObject<{
     cssStyles: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
@@ -3370,7 +3371,7 @@ export declare const mulmoSlideParamsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const beatAudioParamsSchema: z.ZodObject<{
     padding: z.ZodOptional<z.ZodNumber>;
-    movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    movieVolume: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const mulmoHtmlImageParamsSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
@@ -3393,6 +3394,12 @@ export declare const audioParamsSchema: z.ZodObject<{
     bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    movieVolume: z.ZodOptional<z.ZodNumber>;
+    ttsVolume: z.ZodOptional<z.ZodNumber>;
+    ducking: z.ZodOptional<z.ZodObject<{
+        ratio: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const htmlPromptParamsSchema: z.ZodObject<{
     systemPrompt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -3683,6 +3690,7 @@ export declare const mulmoMovieParamsSchema: z.ZodObject<{
             STYLE: "STYLE";
         }>;
     }, z.core.$strip>>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const mulmoBeatSchema: z.ZodObject<{
     speaker: z.ZodOptional<z.ZodString>;
@@ -6336,7 +6344,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
     }, z.core.$strict>>;
     audioParams: z.ZodOptional<z.ZodObject<{
         padding: z.ZodOptional<z.ZodNumber>;
-        movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     movieParams: z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -6576,6 +6584,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
         speed: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -6824,6 +6833,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
             }>>;
             opacity: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>]>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -7063,6 +7073,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -7181,6 +7192,12 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
         bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
+        ttsVolume: z.ZodOptional<z.ZodNumber>;
+        ducking: z.ZodOptional<z.ZodObject<{
+            ratio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const mulmoReferenceSchema: z.ZodObject<{
@@ -7320,6 +7337,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
             }>>;
             opacity: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>]>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -7559,6 +7577,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -7677,6 +7696,12 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
+        ttsVolume: z.ZodOptional<z.ZodNumber>;
+        ducking: z.ZodOptional<z.ZodObject<{
+            ratio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -10345,7 +10370,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         }, z.core.$strict>>;
         audioParams: z.ZodOptional<z.ZodObject<{
             padding: z.ZodOptional<z.ZodNumber>;
-            movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         movieParams: z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -10585,6 +10610,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
             speed: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -10908,6 +10934,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -11147,6 +11174,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -11265,6 +11293,12 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -13933,7 +13967,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             }, z.core.$strict>>;
             audioParams: z.ZodOptional<z.ZodObject<{
                 padding: z.ZodOptional<z.ZodNumber>;
-                movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                movieVolume: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strict>>;
             movieParams: z.ZodOptional<z.ZodObject<{
                 provider: z.ZodOptional<z.ZodEnum<{
@@ -14173,6 +14207,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                         STYLE: "STYLE";
                     }>;
                 }, z.core.$strip>>>;
+                concurrency: z.ZodOptional<z.ZodNumber>;
                 speed: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -14432,6 +14467,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -14671,6 +14707,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -14789,6 +14826,12 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
 }, z.core.$strict>;
@@ -14922,6 +14965,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -15161,6 +15205,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -15279,6 +15324,12 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
     filename: z.ZodString;

package/lib/types/schema.js

@@ -393,6 +393,7 @@ export const mulmoImageParamsSchema = mulmoBeatImageParamsSchema
     .extend({
     images: mulmoImageParamsImagesSchema.optional(),
     backgroundImage: backgroundImageSchema,
+    concurrency: z.number().int().positive().optional().describe("Max concurrent image generation requests"),
 })
     .strict();
 export const textSlideParamsSchema = z
@@ -409,7 +410,7 @@ export const mulmoSlideParamsSchema = z
 export const beatAudioParamsSchema = z
     .object({
     padding: z.number().optional().describe("Padding between beats"), // seconds
-    movieVolume: z.number().optional().default(1.0).describe("Audio volume of the imported or generated movie"),
+    movieVolume: z.number().min(0).max(1).optional().describe("Audio volume of the imported or generated movie"),
 })
     .strict();
 export const mulmoHtmlImageParamsSchema = z
@@ -428,6 +429,15 @@ export const audioParamsSchema = z
     bgmVolume: z.number().optional().default(0.2).describe("Volume of the background music"),
     audioVolume: z.number().optional().default(1.0).describe("Volume of the audio"),
     suppressSpeech: z.boolean().optional().default(false).describe("Suppress speech generation"),
+    movieVolume: z.number().min(0).max(1).optional().describe("Default movie audio volume for all beats"),
+    ttsVolume: z.number().min(0).max(2).optional().describe("TTS narration volume before mixing with BGM/movie audio"),
+    ducking: z
+        .object({
+        ratio: z.number().min(0).max(1).optional().describe("Movie volume ratio during TTS beats (default 0.3)"),
+    })
+        .optional()
+        .describe("Auto-reduce movie audio when TTS is playing"),
+    concurrency: z.number().int().positive().optional().describe("Max concurrent TTS generation requests"),
 })
     .strict();
 export const htmlPromptParamsSchema = z
@@ -488,6 +498,7 @@ export const mulmoMovieParamsSchema = z.object({
         .array(movieReferenceImageSchema)
         .optional()
         .describe("Style/asset reference images (Veo 3.1). Mutually exclusive with imageName/lastFrameImageName"),
+    concurrency: z.number().int().positive().optional().describe("Max concurrent movie generation requests"),
 });
 export const mulmoBeatSchema = z
     .object({

package/lib/utils/context.d.ts

@@ -115,6 +115,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 size?: "contain" | "cover" | "fill" | "auto" | undefined;
                 opacity?: number | undefined;
             } | null | undefined;
+            concurrency?: number | undefined;
         };
         movieParams: {
             provider?: string | undefined;
@@ -280,6 +281,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 imageName: string;
                 referenceType: "ASSET" | "STYLE";
             }[] | undefined;
+            concurrency?: number | undefined;
         };
         soundEffectParams: {
             provider?: string | undefined;
@@ -303,6 +305,12 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 kind: "path";
                 path: string;
             } | undefined;
+            movieVolume?: number | undefined;
+            ttsVolume?: number | undefined;
+            ducking?: {
+                ratio?: number | undefined;
+            } | undefined;
+            concurrency?: number | undefined;
         };
         lang: string;
         beats: {
@@ -1846,8 +1854,8 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 vertexai_location?: string | undefined;
             } | undefined;
             audioParams?: {
-                movieVolume: number;
                 padding?: number | undefined;
+                movieVolume?: number | undefined;
             } | undefined;
             movieParams?: {
                 provider?: string | undefined;
@@ -2013,6 +2021,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                     imageName: string;
                     referenceType: "ASSET" | "STYLE";
                 }[] | undefined;
+                concurrency?: number | undefined;
                 speed?: number | undefined;
             } | undefined;
             soundEffectParams?: {
@@ -2342,6 +2351,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     size?: "contain" | "cover" | "fill" | "auto" | undefined;
                     opacity?: number | undefined;
                 } | null | undefined;
+                concurrency?: number | undefined;
             };
             movieParams: {
                 provider?: string | undefined;
@@ -2507,6 +2517,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     imageName: string;
                     referenceType: "ASSET" | "STYLE";
                 }[] | undefined;
+                concurrency?: number | undefined;
             };
             soundEffectParams: {
                 provider?: string | undefined;
@@ -2530,6 +2541,12 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     kind: "path";
                     path: string;
                 } | undefined;
+                movieVolume?: number | undefined;
+                ttsVolume?: number | undefined;
+                ducking?: {
+                    ratio?: number | undefined;
+                } | undefined;
+                concurrency?: number | undefined;
             };
             lang: string;
             beats: {
@@ -4073,8 +4090,8 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     vertexai_location?: string | undefined;
                 } | undefined;
                 audioParams?: {
-                    movieVolume: number;
                     padding?: number | undefined;
+                    movieVolume?: number | undefined;
                 } | undefined;
                 movieParams?: {
                     provider?: string | undefined;
@@ -4240,6 +4257,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                         imageName: string;
                         referenceType: "ASSET" | "STYLE";
                     }[] | undefined;
+                    concurrency?: number | undefined;
                     speed?: number | undefined;
                 } | undefined;
                 soundEffectParams?: {
@@ -4576,6 +4594,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 size?: "contain" | "cover" | "fill" | "auto" | undefined;
                 opacity?: number | undefined;
             } | null | undefined;
+            concurrency?: number | undefined;
         };
         movieParams: {
             provider?: string | undefined;
@@ -4741,6 +4760,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 imageName: string;
                 referenceType: "ASSET" | "STYLE";
             }[] | undefined;
+            concurrency?: number | undefined;
         };
         soundEffectParams: {
             provider?: string | undefined;
@@ -4764,6 +4784,12 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 kind: "path";
                 path: string;
             } | undefined;
+            movieVolume?: number | undefined;
+            ttsVolume?: number | undefined;
+            ducking?: {
+                ratio?: number | undefined;
+            } | undefined;
+            concurrency?: number | undefined;
         };
         lipSyncParams?: {
             provider?: string | undefined;

package/lib/utils/image_plugins/html_tailwind.d.ts

@@ -15,6 +15,11 @@ export declare const resolveMovieRefs: (html: string, movieRefs: Record<string,
  * Paths starting with http://, https://, file://, data:, image:, or / are left unchanged.
  */
 export declare const resolveRelativeImagePaths: (html: string, baseDirPath: string) => string;
+/**
+ * Resolve relative modelUrl assignment in user scripts to file:// absolute paths.
+ * e.g. const modelUrl = "models/a.glb" -> const modelUrl = "file:///abs/models/a.glb"
+ */
+export declare const resolveRelativeModelPathsInScript: (html: string, baseDirPath: string) => string;
 export declare const process: (params: ImageProcessorParams) => Promise<string | undefined>;
 export declare const path: (params: ImageProcessorParams) => string;
 export declare const html: (params: ImageProcessorParams) => Promise<string | undefined>;

package/lib/utils/image_plugins/html_tailwind.js

@@ -38,8 +38,16 @@ export const resolveMovieRefs = (html, movieRefs) => {
  * Paths starting with http://, https://, file://, data:, image:, or / are left unchanged.
  */
 export const resolveRelativeImagePaths = (html, baseDirPath) => {
-    return html.replace(/(\bsrc\s*=\s*)(["'])((?!https?:\/\/|file:\/\/|data:|image:|\/)[^"']+)\2/gi, (_, prefix, quote, relativePath) => {
-        const absolutePath = nodePath.resolve(baseDirPath, relativePath);
+    return html.replace(/(\bsrc\s*=\s*)(["'])([^"']+)\2/gi, (_, prefix, quote, pathValue) => {
+        const isAbsoluteLike = pathValue.startsWith("http://") ||
+            pathValue.startsWith("https://") ||
+            pathValue.startsWith("file://") ||
+            pathValue.startsWith("data:") ||
+            pathValue.startsWith("image:") ||
+            pathValue.startsWith("/");
+        if (isAbsoluteLike)
+            return `${prefix}${quote}${pathValue}${quote}`;
+        const absolutePath = nodePath.resolve(baseDirPath, pathValue);
         return `${prefix}${quote}file://${absolutePath}${quote}`;
     });
 };
@@ -52,7 +60,48 @@ const buildUserScript = (script) => {
     if (!script)
         return "";
     const code = Array.isArray(script) ? script.join("\n") : script;
-    return `<script>\n${code}\n</script>`;
+    // If user script contains ESM import/export, emit module script so imports work.
+    const isModule = code.split("\n").some((line) => {
+        const trimmed = line.trimStart();
+        return trimmed.startsWith("import ") || trimmed.startsWith("export ");
+    });
+    return isModule ? `<script type="module">\n${code}\n</script>` : `<script>\n${code}\n</script>`;
+};
+/**
+ * Resolve relative modelUrl assignment in user scripts to file:// absolute paths.
+ * e.g. const modelUrl = "models/a.glb" -> const modelUrl = "file:///abs/models/a.glb"
+ */
+export const resolveRelativeModelPathsInScript = (html, baseDirPath) => {
+    const lines = html.split("\n");
+    return lines
+        .map((line) => {
+        const hasModelDeclaration = line.includes("modelUrl") && (line.includes("const ") || line.includes("let ") || line.includes("var "));
+        if (!hasModelDeclaration || !line.includes("="))
+            return line;
+        const eqIndex = line.indexOf("=");
+        const afterEq = line.slice(eqIndex + 1);
+        const singleQuoteIndex = afterEq.indexOf("'");
+        const doubleQuoteIndex = afterEq.indexOf('"');
+        const quoteIndex = singleQuoteIndex >= 0 && (doubleQuoteIndex < 0 || singleQuoteIndex < doubleQuoteIndex) ? singleQuoteIndex : doubleQuoteIndex;
+        if (quoteIndex < 0)
+            return line;
+        const quoteChar = afterEq[quoteIndex];
+        const start = eqIndex + 1 + quoteIndex;
+        const end = line.indexOf(quoteChar, start + 1);
+        if (end < 0)
+            return line;
+        const rawPath = line.slice(start + 1, end);
+        const isAbsoluteLike = rawPath.startsWith("http://") ||
+            rawPath.startsWith("https://") ||
+            rawPath.startsWith("file://") ||
+            rawPath.startsWith("data:") ||
+            rawPath.startsWith("/");
+        if (isAbsoluteLike)
+            return line;
+        const absolutePath = nodePath.resolve(baseDirPath, rawPath);
+        return `${line.slice(0, start + 1)}file://${absolutePath}${line.slice(end)}`;
+    })
+        .join("\n");
 };
 /**
  * Resolve HTML and script from beat image data.
@@ -106,7 +155,8 @@ const buildAnimatedHtml = (params, totalFrames, fps) => {
     });
     const resolvedImageRefs = resolveImageRefs(rawHtmlData, params.imageRefs ?? {});
     const resolvedAllRefs = resolveMovieRefs(resolvedImageRefs, params.movieRefs ?? {});
-    return resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const resolvedImages = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    return resolveRelativeModelPathsInScript(resolvedImages, context.fileDirs.mulmoFileDirPath);
 };
 const processHtmlTailwindAnimated = async (params) => {
     const { beat, imagePath, canvasSize } = params;
@@ -163,7 +213,8 @@ const processHtmlTailwindStatic = async (params) => {
     });
     const resolvedImageRefs = resolveImageRefs(rawHtmlData, params.imageRefs ?? {});
     const resolvedAllRefs = resolveMovieRefs(resolvedImageRefs, params.movieRefs ?? {});
-    const htmlData = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const resolvedImages = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const htmlData = resolveRelativeModelPathsInScript(resolvedImages, context.fileDirs.mulmoFileDirPath);
     await renderHTMLToImage(htmlData, imagePath, canvasSize.width, canvasSize.height);
     return imagePath;
 };