samsar-js 0.48.32 → 0.48.34

package/README.md

@@ -37,6 +37,10 @@ const video = await samsar.createVideoFromText(
     image_model: 'GPTIMAGE2',
     video_model: 'RUNWAYML',
     duration: 30,
+    backingtrack_model: 'LYRIA3',
+    tts_model: 'OPENAI',
+    speakerOptions: { openAISpeakers: ['nova'] },
+    inference_model: 'gpt-5.5',
     font_key: 'Poppins',
     enable_subtitles: true,
   },
@@ -67,6 +71,10 @@ const videoFromImages = await samsar.createVideoFromImageList(
     video_model: 'RUNWAYML',
     aspect_ratio: '16:9',
     language: 'en',
+    backingtrack_model: 'ELEVENLABS_MUSIC',
+    tts_model: 'ELEVENLABS',
+    speakerOptions: { elevenLabsSpeakers: ['EXAVITQu4vr4xnSDxMaL'] },
+    inference_model: 'gemini-3.1-pro',
     font_key: 'Poppins',
     enable_subtitles: true,
   },
@@ -107,6 +115,20 @@ await samsar.createVideoFromImageList({
   ],
 });
 
+// Create a video and generate the outro with a center logo/CTA image instead of a QR code
+await samsar.createVideoFromImageList({
+  image_urls: ['https://example.com/a.jpg', 'https://example.com/b.jpg'],
+  prompt: 'Product launch teaser with a branded CTA outro',
+  video_model: 'RUNWAYML',
+  aspect_ratio: '9:16',
+  generate_outro_image: true,
+  outro_cta_image: {
+    top_text: 'Shop the drop',
+    middle_image: { url: 'https://cdn.example.com/drop-logo.png' },
+    bottom_text: 'Limited availability',
+  },
+});
+
 // Create the same generated QR outro and per-scene footer CTAs from one CTA link
 await samsar.createVideoFromImageList({
   image_urls: [
@@ -146,6 +168,20 @@ await samsar.updateVideoOutroImage(
   { webhookUrl: 'https://example.com/webhook' },
 );
 
+// Update an existing outro by generating a new CTA outro with a center logo/CTA image
+await samsar.updateVideoOutroImage(
+  {
+    videoSessionId: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+    generate_outro_image: true,
+    outro_cta_image: {
+      top_text: 'Shop the drop',
+      middle_image: { url: 'https://cdn.example.com/drop-logo.png' },
+      bottom_text: 'Limited availability',
+    },
+  },
+  { webhookUrl: 'https://example.com/webhook' },
+);
+
 // Update the footer CTA on an existing video session
 await samsar.updateVideoFooterImage(
   {
@@ -489,13 +525,15 @@ const externalRender = await platform.createExternalVideoFromText(externalUser,
   enable_subtitles: true,
 });
 
-// Update an external user's existing outro by generating a new QR CTA outro
+// Update an external user's existing outro by generating a center logo/CTA image outro
 const externalOutroUpdate = await platform.updateExternalVideoOutroImage(externalUser, {
   request_id: externalRender.data.request_id,
   generate_outro_image: true,
-  cta_url: 'https://example.com/shop',
-  cta_text_top: 'Scan to shop',
-  cta_text_bottom: 'Limited drop',
+  outro_cta_image: {
+    top_text: 'Shop the drop',
+    middle_image: { url: 'https://cdn.example.com/drop-logo.png' },
+    bottom_text: 'Limited availability',
+  },
   add_outro_animation: true,
 });
 console.log(externalOutroUpdate.data.request_id);
@@ -574,14 +612,17 @@ console.log(externalLibrary.data.requests.map((request) => request.request_id));
 
 Video model support notes:
 - `createVideoFromText` image model keys include: `GPTIMAGE2`, `IMAGEN4`, `SEEDREAM`, `NANOBANANA2`, `NANOBANANAPRO`, `CUSTOM_TEXT_TO_IMAGE`.
-- `createVideoFromText` supports these video models: `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SEEDANCEI2V` (Seedance 1.5), `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V`.
-- `createVideoFromText` accepts either a provided outro (`outro_image_url`) or server-generated QR outro (`generate_outro_image: true` with `cta_url`). It can also render bottom CTA footer QR cards with `add_footer_animation` and `footer_metadata`; one footer item applies to every generated scene, while multiple items map by scene index.
-- `createVideoFromImageList` supports `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SEEDANCEI2V`, `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V` via `video_model`; if omitted, it defaults to `RUNWAYML`. It also accepts the same `image_model` keys as text-to-video. Use `aspect_ratio: '16:9'` or `'9:16'`; omitted or invalid values fall back to `16:9`.
-- `createVideoFromImageList` accepts either a provided outro (`outro_image_url`) or server-generated QR outro (`generate_outro_image: true` with `cta_url`). Do not combine the two modes in a single request.
+- `createVideoFromText` supports these video models: `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `COSMOS3SUPERI2V`, `SEEDANCEI2V` (Seedance 1.5), `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V`.
+- `createVideoFromText` accepts either a provided outro (`outro_image_url`) or a server-generated CTA outro (`generate_outro_image: true` with `cta_url` for a QR center image, or `outro_cta_image` for a supplied center logo/CTA image). It can also render bottom CTA footer QR cards with `add_footer_animation` and `footer_metadata`; one footer item applies to every generated scene, while multiple items map by scene index.
+- `createVideoFromImageList` supports `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `COSMOS3SUPERI2V`, `SEEDANCEI2V`, `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V` via `video_model`; if omitted, it defaults to `RUNWAYML`. It also accepts the same `image_model` keys as text-to-video. Use `aspect_ratio: '16:9'` or `'9:16'`; omitted or invalid values fall back to `16:9`.
+- Text and image-list video creation both accept optional `backingtrack_model` / `backing_track_model` / `backingTrackModel` / `music_provider` / `musicProvider`, `tts_model` / `ttsModel` / `tts_provider` / `ttsProvider`, `speakerOptions` / `speaker_options`, and `inference_model` / `inferenceModel`. The adapter normalizes these to `backingtrack_model`, `tts_model`, `speakerOptions`, and `inference_model` in the request payload. Omit `inference_model` to use the account default; supported request values are `gpt-5.5` and `gemini-3.1-pro`. When `tts_model` is set, Samsar limits assignment to the matching speaker list (`openAISpeakers`, `elevenLabsSpeakers`, or `googleSpeakers`; Google TTS requests should include `googleSpeakerDetails`).
+- `video_model_sub_type` is no longer used by the API and is stripped from text and image-list payloads before sending.
+- `createVideoFromImageList` accepts either a provided outro (`outro_image_url`) or a server-generated CTA outro (`generate_outro_image: true` with `cta_url` for a QR center image, or `outro_cta_image` for a supplied center logo/CTA image). Do not combine the two modes in a single request.
+- `outro_cta_image` uses the structured shape `{ top_text, middle_image, bottom_text }`. `middle_image` accepts a public image URL (`{ url }`, `{ image_url }`) or image data (`{ data_url }`, `{ image_data, mime_type }`) and is resized into the same center area used by QR outros without changing aspect ratio.
 - `createVideoFromImageList` can render per-scene footer QR cards by setting `add_footer_animation: true` and providing one `footer_metadata` item per image scene.
 - `createVideoFromImageList` can also generate QR outro CTA text and each scene footer CTA from a single link by setting `express_cta_generation: true` with `cta_url`. CamelCase `expressCtaGeneration` and compatibility aliases `auto_generate_cta_text` / `generate_cta_texts` are normalized to the same API field.
 - `createVideoFromImageList` accepts `limit_single_narrator: true` to keep all narration under one narrator identity. `add_narrator_avatar: true` automatically enables `limit_single_narrator`, generates an influencer-style human narrator avatar, and overlays it bottom-center or centered in the footer row when footer metadata is present.
-- `updateVideoOutroImage` accepts either a replacement outro image URL (`outro_image_url`, `outroImageUrl`, `new_outro_image_url`) or a generated QR CTA outro (`generate_outro_image: true` with `cta_url`, or just `cta_url` when no outro image URL is supplied). Generated outro updates reuse the existing session image layers for tiling and only queue frame/video regeneration.
+- `updateVideoOutroImage` accepts either a replacement outro image URL (`outro_image_url`, `outroImageUrl`, `new_outro_image_url`) or a generated CTA outro (`generate_outro_image: true` with `cta_url` or `outro_cta_image`, or just `cta_url` / `outro_cta_image` when no outro image URL is supplied). Generated outro updates reuse the existing session image layers for tiling and only queue frame/video regeneration.
 - `updateVideoFooterImage` updates the footer CTA on a cloned session with `cta_text`, `cta_logo`, and/or `cta_url`, or removes all scene footers with `remove_footer: true`. Footer updates queue only frame/video regeneration.
 - `cloneVideo` creates a deep copy of a completed session and queues only the final video render so the clone receives a new rendered video path and URL. It does not charge credits.
 - Main video methods and external-user methods accept the same generated outro and footer parameters. The API can resolve either internal session ids or external `extreq_...` ids on repeated video routes, so client code can keep using `translateVideo`, `joinVideos`, `addSubtitles`, `removeSubtitles`, `addVideoOutroImage`, `updateVideoOutroImage`, and `updateVideoFooterImage`; the explicit external variants are available when you want to call `/external_users/*` directly. Do not strip the `extreq_` prefix.

package/dist/index.d.ts

@@ -36,6 +36,83 @@ export interface FontOptions {
     language?: string;
     family?: string;
 }
+export type BackingTrackModel = 'LYRIA3' | 'LYRIA2' | 'ELEVENLABS_MUSIC' | 'Lyria 3' | 'Lyria 2' | 'ElevenLabs music' | string;
+export type TTSModel = 'ELEVENLABS' | 'OPENAI' | 'GOOGLE' | 'ElevenLabs' | 'OpenAI' | 'Google TTS' | string;
+export type InferenceModel = 'gpt-5.5' | 'GPT 5.5' | 'gemini-3.1-pro' | 'Gemini 3.1 Pro' | string;
+export interface GoogleTTSSpeakerDetail {
+    provider?: 'GOOGLE' | string;
+    value?: string;
+    voiceId?: string;
+    name?: string;
+    label?: string;
+    languageCode?: string;
+    languageCodes?: string[];
+    Gender?: 'M' | 'F' | '' | string | null;
+    gender?: string;
+    genderCode?: string;
+    ssmlGender?: string;
+    naturalSampleRateHertz?: number | null;
+    voiceType?: string;
+    previewRequiresAuth?: boolean;
+    [key: string]: unknown;
+}
+export interface TTSSpeakerOptions {
+    allowOpenAI?: boolean;
+    allowElevenLabs?: boolean;
+    allowGoogle?: boolean;
+    openAISpeakers?: string[];
+    elevenLabsSpeakers?: string[];
+    googleSpeakers?: string[];
+    googleSpeakerDetails?: GoogleTTSSpeakerDetail[];
+    [key: string]: unknown;
+}
+export type OutroCtaImageSource = string | {
+    url?: string;
+    image_url?: string;
+    imageUrl?: string;
+    public_url?: string;
+    publicUrl?: string;
+    source_url?: string;
+    sourceUrl?: string;
+    source?: string;
+    src?: string;
+    image?: string;
+    data_url?: string;
+    dataUrl?: string;
+    image_data?: string;
+    imageData?: string;
+    data?: string;
+    mime_type?: string;
+    mimeType?: string;
+    content_type?: string;
+    contentType?: string;
+    [key: string]: unknown;
+};
+export interface OutroCtaImagePayload {
+    top_text?: string;
+    topText?: string;
+    cta_text_top?: string;
+    ctaTextTop?: string;
+    middle_image?: OutroCtaImageSource;
+    middleImage?: OutroCtaImageSource;
+    center_image?: OutroCtaImageSource;
+    centerImage?: OutroCtaImageSource;
+    middle?: OutroCtaImageSource;
+    center?: OutroCtaImageSource;
+    bottom_text?: string;
+    bottomText?: string;
+    cta_text_bottom?: string;
+    ctaTextBottom?: string;
+    url?: string;
+    image_url?: string;
+    imageUrl?: string;
+    src?: string;
+    data_url?: string;
+    dataUrl?: string;
+    image_data?: string;
+    imageData?: string;
+    [key: string]: unknown;
+}
 export type V2StepGenerationMode = 'one_step' | 'two_step';
 export interface V2StepGenerationOptions {
     auto_render_full_video?: boolean;
@@ -50,7 +127,19 @@ export interface CreateVideoFromTextInput extends V2StepGenerationOptions {
     duration: number;
     tone?: string;
     aspect_ratio?: string;
-    video_model_sub_type?: string;
+    backingtrack_model?: BackingTrackModel;
+    backing_track_model?: BackingTrackModel;
+    backingTrackModel?: BackingTrackModel;
+    music_provider?: BackingTrackModel;
+    musicProvider?: BackingTrackModel;
+    tts_model?: TTSModel;
+    ttsModel?: TTSModel;
+    tts_provider?: TTSModel;
+    ttsProvider?: TTSModel;
+    inference_model?: InferenceModel;
+    inferenceModel?: InferenceModel;
+    speakerOptions?: TTSSpeakerOptions;
+    speaker_options?: TTSSpeakerOptions;
     font_key?: string;
     fontKey?: string;
     subtitle_font?: string;
@@ -85,6 +174,10 @@ export interface CreateVideoFromTextInput extends V2StepGenerationOptions {
     ctaTextBottom?: string;
     cta_logo?: string;
     ctaLogo?: string;
+    outro_cta_image?: OutroCtaImagePayload | string;
+    outroCtaImage?: OutroCtaImagePayload | string;
+    cta_image?: OutroCtaImagePayload | string;
+    ctaImage?: OutroCtaImagePayload | string;
     add_footer_animation?: boolean;
     addFooterAnimation?: boolean;
     footer_metadata?: FooterMetadataItem[];
@@ -118,7 +211,7 @@ export interface FooterMetadataItem {
     footerLogoImagePath?: string;
 }
 export type ImageListToVideoAspectRatio = '16:9' | '9:16';
-export type ImageListToVideoModel = 'RUNWAYML' | 'VEO3.1I2V' | 'VEO3.1I2VFAST' | 'SEEDANCEI2V' | 'KLINGIMGTOVID3PRO' | 'HAPPYHORSEI2V';
+export type ImageListToVideoModel = 'RUNWAYML' | 'VEO3.1I2V' | 'VEO3.1I2VFAST' | 'COSMOS3SUPERI2V' | 'SEEDANCEI2V' | 'KLINGIMGTOVID3PRO' | 'HAPPYHORSEI2V';
 export interface ImageListToVideoItem {
     image_url?: string;
     imageUrl?: string;
@@ -155,6 +248,19 @@ export interface CreateVideoFromImageListInput extends V2StepGenerationOptions {
     aspectRatio?: ImageListToVideoAspectRatio;
     language?: string;
     languageString?: string | null;
+    backingtrack_model?: BackingTrackModel;
+    backing_track_model?: BackingTrackModel;
+    backingTrackModel?: BackingTrackModel;
+    music_provider?: BackingTrackModel;
+    musicProvider?: BackingTrackModel;
+    tts_model?: TTSModel;
+    ttsModel?: TTSModel;
+    tts_provider?: TTSModel;
+    ttsProvider?: TTSModel;
+    inference_model?: InferenceModel;
+    inferenceModel?: InferenceModel;
+    speakerOptions?: TTSSpeakerOptions;
+    speaker_options?: TTSSpeakerOptions;
     font_key?: string;
     fontKey?: string;
     subtitle_font?: string;
@@ -193,6 +299,10 @@ export interface CreateVideoFromImageListInput extends V2StepGenerationOptions {
     ctaTextBottom?: string;
     cta_logo?: string;
     ctaLogo?: string;
+    outro_cta_image?: OutroCtaImagePayload | string;
+    outroCtaImage?: OutroCtaImagePayload | string;
+    cta_image?: OutroCtaImagePayload | string;
+    ctaImage?: OutroCtaImagePayload | string;
     add_footer_animation?: boolean;
     addFooterAnimation?: boolean;
     footer_metadata?: FooterMetadataItem[];
@@ -319,6 +429,10 @@ export interface UpdateVideoOutroImageInput {
     ctaTextBottom?: string;
     cta_logo?: string;
     ctaLogo?: string;
+    outro_cta_image?: OutroCtaImagePayload | string;
+    outroCtaImage?: OutroCtaImagePayload | string;
+    cta_image?: OutroCtaImagePayload | string;
+    ctaImage?: OutroCtaImagePayload | string;
     [key: string]: unknown;
 }
 export interface UpdateVideoOutroImageResponse {
@@ -389,6 +503,20 @@ export interface AddVideoOutroImageInput {
     outro_focus_area?: OutroFocusArea | null;
     outroFocustArea?: OutroFocusArea | null;
     outroFocusArea?: OutroFocusArea | null;
+    generate_outro_image?: boolean;
+    generateOutroImage?: boolean;
+    cta_url?: string;
+    ctaUrl?: string;
+    cta_text_top?: string;
+    ctaTextTop?: string;
+    cta_text_bottom?: string;
+    ctaTextBottom?: string;
+    cta_logo?: string;
+    ctaLogo?: string;
+    outro_cta_image?: OutroCtaImagePayload | string;
+    outroCtaImage?: OutroCtaImagePayload | string;
+    cta_image?: OutroCtaImagePayload | string;
+    ctaImage?: OutroCtaImagePayload | string;
     [key: string]: unknown;
 }
 export interface AddVideoOutroImageResponse {

package/dist/index.js

@@ -41,6 +41,58 @@ function assertOptionalBoolean(value, fieldName, context = 'createVideoFromImage
         throw new Error(`${fieldName} must be a boolean for ${context}`);
     }
 }
+function hasOutroCtaImageSource(value) {
+    if (typeof value === 'string') {
+        return Boolean(value.trim());
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const record = value;
+    const middleImage = getFirstDefinedInputValue(record, [
+        'middle_image',
+        'middleImage',
+        'center_image',
+        'centerImage',
+        'middle',
+        'center',
+    ]);
+    if (middleImage !== undefined) {
+        return hasOutroCtaImageSource(middleImage);
+    }
+    return Boolean(getTrimmedString(record.url) ??
+        getTrimmedString(record.image_url) ??
+        getTrimmedString(record.imageUrl) ??
+        getTrimmedString(record.public_url) ??
+        getTrimmedString(record.publicUrl) ??
+        getTrimmedString(record.source_url) ??
+        getTrimmedString(record.sourceUrl) ??
+        getTrimmedString(record.source) ??
+        getTrimmedString(record.src) ??
+        getTrimmedString(record.image) ??
+        getTrimmedString(record.middle_image_url) ??
+        getTrimmedString(record.middleImageUrl) ??
+        getTrimmedString(record.center_image_url) ??
+        getTrimmedString(record.centerImageUrl) ??
+        getTrimmedString(record.data_url) ??
+        getTrimmedString(record.dataUrl) ??
+        getTrimmedString(record.image_data) ??
+        getTrimmedString(record.imageData) ??
+        getTrimmedString(record.data));
+}
+function normalizeOutroCtaImageInput(raw, context) {
+    const value = resolveAliasedInputValue(raw, ['outro_cta_image', 'outroCtaImage', 'cta_image', 'ctaImage'], 'outro_cta_image');
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== 'string' && (typeof value !== 'object' || Array.isArray(value))) {
+        throw new Error(`outro_cta_image must be a string or object for ${context}`);
+    }
+    if (!hasOutroCtaImageSource(value)) {
+        throw new Error(`outro_cta_image.middle_image is required for ${context}`);
+    }
+    return value;
+}
 function getFirstDefinedInputValue(raw, aliases) {
     for (const alias of aliases) {
         if (Object.prototype.hasOwnProperty.call(raw, alias)) {
@@ -135,8 +187,13 @@ function normalizeCreateVideoFromTextInput(input) {
         ['cta_text_top', ['cta_text_top', 'ctaTextTop']],
         ['cta_text_bottom', ['cta_text_bottom', 'ctaTextBottom']],
         ['cta_logo', ['cta_logo', 'ctaLogo']],
+        ['outro_cta_image', ['outro_cta_image', 'outroCtaImage', 'cta_image', 'ctaImage']],
         ['add_footer_animation', ['add_footer_animation', 'addFooterAnimation']],
         ['footer_metadata', ['footer_metadata', 'footerMetadata']],
+        ['backingtrack_model', ['backingtrack_model', 'backing_track_model', 'backingTrackModel', 'music_provider', 'musicProvider']],
+        ['tts_model', ['tts_model', 'ttsModel', 'tts_provider', 'ttsProvider']],
+        ['inference_model', ['inference_model', 'inferenceModel']],
+        ['speakerOptions', ['speakerOptions', 'speaker_options']],
         ['enable_subtitles', ['enable_subtitles', 'enableSubtitles']],
         ['font_key', ['font_key', 'fontKey']],
     ];
@@ -146,6 +203,8 @@ function normalizeCreateVideoFromTextInput(input) {
             normalized[canonicalName] = value;
         }
     }
+    delete normalized.video_model_sub_type;
+    delete normalized.videoModelSubType;
     assertOptionalBoolean(normalized.enable_subtitles, 'enable_subtitles', 'createVideoFromText');
     assertOptionalBoolean(normalized.add_outro_animation, 'add_outro_animation', 'createVideoFromText');
     assertOptionalBoolean(normalized.add_outro_focus_area, 'add_outro_focus_area', 'createVideoFromText');
@@ -153,11 +212,21 @@ function normalizeCreateVideoFromTextInput(input) {
     assertOptionalBoolean(normalized.add_footer_animation, 'add_footer_animation', 'createVideoFromText');
     if (normalized.generate_outro_image === true) {
         const ctaUrl = typeof normalized.cta_url === 'string' ? normalized.cta_url.trim() : '';
-        if (!ctaUrl) {
-            throw new Error('cta_url is required when generate_outro_image is true for createVideoFromText');
+        const outroCtaImage = normalizeOutroCtaImageInput(normalized, 'createVideoFromText');
+        if (outroCtaImage !== undefined) {
+            normalized.outro_cta_image = outroCtaImage;
+        }
+        if (!ctaUrl && !outroCtaImage) {
+            throw new Error('cta_url or outro_cta_image is required when generate_outro_image is true for createVideoFromText');
         }
     }
-    else if (normalized.add_outro_focus_area === true && normalized.add_outro_animation !== true) {
+    else {
+        const outroCtaImage = normalizeOutroCtaImageInput(normalized, 'createVideoFromText');
+        if (outroCtaImage !== undefined) {
+            normalized.outro_cta_image = outroCtaImage;
+        }
+    }
+    if (normalized.generate_outro_image !== true && normalized.add_outro_focus_area === true && normalized.add_outro_animation !== true) {
         throw new Error('add_outro_focus_area requires add_outro_animation to be true for createVideoFromText');
     }
     return normalized;
@@ -191,8 +260,13 @@ function normalizeCreateVideoFromImageListInput(input) {
         ['cta_text_top', ['cta_text_top', 'ctaTextTop']],
         ['cta_text_bottom', ['cta_text_bottom', 'ctaTextBottom']],
         ['cta_logo', ['cta_logo', 'ctaLogo']],
+        ['outro_cta_image', ['outro_cta_image', 'outroCtaImage', 'cta_image', 'ctaImage']],
         ['add_footer_animation', ['add_footer_animation', 'addFooterAnimation']],
         ['footer_metadata', ['footer_metadata', 'footerMetadata']],
+        ['backingtrack_model', ['backingtrack_model', 'backing_track_model', 'backingTrackModel', 'music_provider', 'musicProvider']],
+        ['tts_model', ['tts_model', 'ttsModel', 'tts_provider', 'ttsProvider']],
+        ['inference_model', ['inference_model', 'inferenceModel']],
+        ['speakerOptions', ['speakerOptions', 'speaker_options']],
         ['limit_single_narrator', ['limit_single_narrator', 'limitSingleNarrator']],
         ['add_narrator_avatar', ['add_narrator_avatar', 'addNarratorAvatar']],
         ['enable_subtitles', ['enable_subtitles', 'enableSubtitles']],
@@ -204,6 +278,8 @@ function normalizeCreateVideoFromImageListInput(input) {
             normalized[canonicalName] = value;
         }
     }
+    delete normalized.video_model_sub_type;
+    delete normalized.videoModelSubType;
     assertOptionalBoolean(normalized.enable_subtitles, 'enable_subtitles');
     assertOptionalBoolean(normalized.add_outro_animation, 'add_outro_animation');
     assertOptionalBoolean(normalized.add_outro_focus_area, 'add_outro_focus_area');
@@ -212,6 +288,10 @@ function normalizeCreateVideoFromImageListInput(input) {
     assertOptionalBoolean(normalized.add_footer_animation, 'add_footer_animation');
     assertOptionalBoolean(normalized.limit_single_narrator, 'limit_single_narrator');
     assertOptionalBoolean(normalized.add_narrator_avatar, 'add_narrator_avatar');
+    const outroCtaImage = normalizeOutroCtaImageInput(normalized, 'createVideoFromImageList');
+    if (outroCtaImage !== undefined) {
+        normalized.outro_cta_image = outroCtaImage;
+    }
     if (normalized.add_narrator_avatar === true) {
         normalized.limit_single_narrator = true;
     }
@@ -228,8 +308,8 @@ function normalizeCreateVideoFromImageListInput(input) {
     }
     if (normalized.generate_outro_image === true) {
         const ctaUrl = typeof normalized.cta_url === 'string' ? normalized.cta_url.trim() : '';
-        if (!ctaUrl) {
-            throw new Error('cta_url is required when generate_outro_image is true for createVideoFromImageList');
+        if (!ctaUrl && !outroCtaImage) {
+            throw new Error('cta_url or outro_cta_image is required when generate_outro_image is true for createVideoFromImageList');
         }
     }
     else if (normalized.add_outro_focus_area === true && normalized.add_outro_animation !== true) {
@@ -358,8 +438,9 @@ function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroI
         raw.ctaTextBottom;
     const ctaLogo = raw.cta_logo ??
         raw.ctaLogo;
+    const outroCtaImage = normalizeOutroCtaImageInput(raw, context);
     const generateOutroImage = rawGenerateOutroImage === true ||
-        (rawGenerateOutroImage === undefined && !outroImageUrl && Boolean(ctaUrl));
+        (rawGenerateOutroImage === undefined && !outroImageUrl && (Boolean(ctaUrl) || Boolean(outroCtaImage)));
     if (!videoSessionId) {
         throw new Error(`videoSessionId is required for ${context}`);
     }
@@ -372,15 +453,15 @@ function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroI
     if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
         throw new Error(`add_outro_focus_area must be a boolean for ${context}`);
     }
-    if (generateOutroImage && outroImageUrl) {
-        throw new Error(`Use either generate_outro_image with cta_url or outro_image_url for ${context}`);
+    if ((generateOutroImage || outroCtaImage) && outroImageUrl) {
+        throw new Error(`Use either generate_outro_image with cta_url/outro_cta_image or outro_image_url for ${context}`);
     }
     if (!generateOutroImage && !outroImageUrl) {
         throw new Error(`outro_image_url is required for ${context} unless generate_outro_image is true`);
     }
     if (generateOutroImage) {
-        if (!ctaUrl || !String(ctaUrl).trim()) {
-            throw new Error(`cta_url is required when generate_outro_image is true for ${context}`);
+        if ((!ctaUrl || !String(ctaUrl).trim()) && !outroCtaImage) {
+            throw new Error(`cta_url or outro_cta_image is required when generate_outro_image is true for ${context}`);
         }
     }
     else if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
@@ -401,7 +482,8 @@ function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroI
         videoSessionId: String(videoSessionId),
         ...(outroImageUrl ? { outro_image_url: String(outroImageUrl) } : {}),
         generate_outro_image: generateOutroImage,
-        ...(generateOutroImage ? { cta_url: String(ctaUrl).trim() } : {}),
+        ...(generateOutroImage && ctaUrl ? { cta_url: String(ctaUrl).trim() } : {}),
+        ...(generateOutroImage && outroCtaImage ? { outro_cta_image: outroCtaImage } : {}),
         ...(ctaTextTop ? { cta_text_top: String(ctaTextTop) } : {}),
         ...(ctaTextBottom ? { cta_text_bottom: String(ctaTextBottom) } : {}),
         ...(ctaLogo ? { cta_logo: String(ctaLogo) } : {}),
@@ -867,8 +949,9 @@ export class SamsarClient {
         }, options);
     }
     async addV2VideoOutroImage(input, options) {
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'addV2VideoOutroImage');
         return this.postV2('add_outro_image', {
-            input,
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         }, options);
     }
@@ -1472,61 +1555,9 @@ export class SamsarClient {
      * re-running frame/video generation.
      */
     async addVideoOutroImage(input, options) {
-        const raw = input;
-        const videoSessionId = raw.videoSessionId ??
-            raw.video_session_id ??
-            raw.videoSessionID ??
-            raw.session_id ??
-            raw.sessionId ??
-            raw.sessionID ??
-            raw.request_id ??
-            raw.requestId;
-        const outroImageUrl = raw.outro_image_url ??
-            raw.outroImageUrl ??
-            raw.new_outro_image_url ??
-            raw.newOutroImageUrl;
-        const rawAddOutroAnimation = raw.add_outro_animation ??
-            raw.addOutroAnimation;
-        const rawAddOutroFocusArea = raw.add_outro_focus_area ??
-            raw.addOutroFocusArea;
-        const rawOutroFocusArea = raw.outro_focust_area ??
-            raw.outro_focus_area ??
-            raw.outroFocustArea ??
-            raw.outroFocusArea;
-        if (!videoSessionId) {
-            throw new Error('videoSessionId is required for addVideoOutroImage');
-        }
-        if (!outroImageUrl) {
-            throw new Error('outro_image_url is required for addVideoOutroImage');
-        }
-        if (rawAddOutroAnimation !== undefined && typeof rawAddOutroAnimation !== 'boolean') {
-            throw new Error('add_outro_animation must be a boolean for addVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
-            throw new Error('add_outro_focus_area must be a boolean for addVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
-            throw new Error('add_outro_focus_area requires add_outro_animation to be true for addVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea === true) {
-            if (!rawOutroFocusArea || typeof rawOutroFocusArea !== 'object' || Array.isArray(rawOutroFocusArea)) {
-                throw new Error('outro_focust_area must be an object with x, y, width, height for addVideoOutroImage');
-            }
-            const { x, y, width, height } = rawOutroFocusArea;
-            const isInvalid = [x, y, width, height].some((value) => typeof value !== 'number' || !Number.isFinite(value));
-            if (isInvalid) {
-                throw new Error('outro_focust_area x, y, width, height must be valid numbers for addVideoOutroImage');
-            }
-        }
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'addVideoOutroImage');
         const body = {
-            input: {
-                ...input,
-                videoSessionId: String(videoSessionId),
-                outro_image_url: String(outroImageUrl),
-                ...(rawAddOutroAnimation !== undefined ? { add_outro_animation: rawAddOutroAnimation === true } : {}),
-                ...(rawAddOutroFocusArea !== undefined ? { add_outro_focus_area: rawAddOutroFocusArea === true } : {}),
-                ...(rawOutroFocusArea !== undefined ? { outro_focust_area: rawOutroFocusArea } : {}),
-            },
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         const response = await this.post('video/add_outro_image', body, options);
@@ -1554,68 +1585,10 @@ export class SamsarClient {
      * Add or replace an outro image for an external-user video request by resolving the external request id.
      */
     async addExternalVideoOutroImage(externalUser, input, options) {
-        const raw = input;
-        const videoSessionId = raw.videoSessionId ??
-            raw.video_session_id ??
-            raw.videoSessionID ??
-            raw.session_id ??
-            raw.sessionId ??
-            raw.sessionID ??
-            raw.request_id ??
-            raw.requestId ??
-            raw.source_request_id ??
-            raw.sourceRequestId ??
-            raw.external_request_id ??
-            raw.externalRequestId ??
-            raw.external_session_id ??
-            raw.externalSessionId;
-        const outroImageUrl = raw.outro_image_url ??
-            raw.outroImageUrl ??
-            raw.new_outro_image_url ??
-            raw.newOutroImageUrl;
-        const rawAddOutroAnimation = raw.add_outro_animation ??
-            raw.addOutroAnimation;
-        const rawAddOutroFocusArea = raw.add_outro_focus_area ??
-            raw.addOutroFocusArea;
-        const rawOutroFocusArea = raw.outro_focust_area ??
-            raw.outro_focus_area ??
-            raw.outroFocustArea ??
-            raw.outroFocusArea;
-        if (!videoSessionId) {
-            throw new Error('videoSessionId is required for addExternalVideoOutroImage');
-        }
-        if (!outroImageUrl) {
-            throw new Error('outro_image_url is required for addExternalVideoOutroImage');
-        }
-        if (rawAddOutroAnimation !== undefined && typeof rawAddOutroAnimation !== 'boolean') {
-            throw new Error('add_outro_animation must be a boolean for addExternalVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
-            throw new Error('add_outro_focus_area must be a boolean for addExternalVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
-            throw new Error('add_outro_focus_area requires add_outro_animation to be true for addExternalVideoOutroImage');
-        }
-        if (rawAddOutroFocusArea === true) {
-            if (!rawOutroFocusArea || typeof rawOutroFocusArea !== 'object' || Array.isArray(rawOutroFocusArea)) {
-                throw new Error('outro_focust_area must be an object with x, y, width, height for addExternalVideoOutroImage');
-            }
-            const { x, y, width, height } = rawOutroFocusArea;
-            const isInvalid = [x, y, width, height].some((value) => typeof value !== 'number' || !Number.isFinite(value));
-            if (isInvalid) {
-                throw new Error('outro_focust_area x, y, width, height must be valid numbers for addExternalVideoOutroImage');
-            }
-        }
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'addExternalVideoOutroImage');
         const body = {
             external_user: normalizeExternalUserIdentity(externalUser),
-            input: {
-                ...input,
-                videoSessionId: String(videoSessionId),
-                outro_image_url: String(outroImageUrl),
-                ...(rawAddOutroAnimation !== undefined ? { add_outro_animation: rawAddOutroAnimation === true } : {}),
-                ...(rawAddOutroFocusArea !== undefined ? { add_outro_focus_area: rawAddOutroFocusArea === true } : {}),
-                ...(rawOutroFocusArea !== undefined ? { outro_focust_area: rawOutroFocusArea } : {}),
-            },
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         return this.post('external_users/add_outro_image', body, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samsar-js",
-  "version": "0.48.32",
+  "version": "0.48.34",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",