Generate commercial multi-shot AI product video ads from image URLs with coherence grading.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer vadyu_live_<API_KEY> from https://vadyu.com/dashboard
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Generate a commercial AI product video ad from a product photo URL (image_url) or base64 image (image_base64). Supports both API v2 Director Recipes (53 presets such as nyc_luxury, minimal_cinema, dtc_story and editorial_flagship, or custom blocks[] combining AI motion scenes, deterministic brand messaging typography cards, synthesized background audio scores, and stark #000000 black-screen brand logo slates) and multi-beat storyboards (problem-solution, ugc-testimonial, product-feature, unboxing, single) in 9:16, 1:1, 16:9, or 4:5. Deterministic text_card and logo_outro blocks consume 0 AI render credits.
Optional RecipeTheme override for typography cards, captions, CTA frames, split dividers, safe zones, and default transitions.
Optional custom API v2 composable timeline (2 to 20 blocks; must include at least 1 'ai_scene' block). Deterministic 'text_card', 'ken_burns_still', 'flash_cut_intro', 'cta_endcard', 'split_before_after', and 'logo_outro' blocks cost 0 render credits.
Aspect ratio: '9:16' (Reels/TikTok/Shorts), '1:1' (Square), '16:9' (YouTube/Web), '4:5' (Meta Feed).
Optional camera motion and lighting direction (e.g., 'Slow 360 studio turntable rotation with warm golden rim lighting, crisp product label').
Optional API v2 Director Recipe preset id. Signature presets: 'nyc_luxury' (NYC cab cameo + brand card + black logo, 14.5s, 2 renders), 'minimal_cinema' (hero + brand card + logo, 9.5s, 1 render), 'dtc_story' (creator hook + value card + lifestyle + logo, 14.5s, 2 renders), 'editorial_flagship' (7 cuts, 20.7s, 2 renders). Recipe Foundry presets (call vadyu_list_recipes for timelines, tags and themes): 'brand_sting_bumper', 'museum_plinth', 'silent_manifesto', 'clinical_clean', 'proof_first_split', 'offer_first_anchor', 'countdown_drop', 'three_reasons', 'pov_it_arrived', 'grand_campaign_12', 'founders_letter', 'craft_documentary', 'film_noir', 'levitation_dream', 'retro_rewind', 'unboxing_asmr', 'rainy_paris_cafe', 'night_drive_neon', 'desert_light', 'greenhouse_botanical', 'holiday_gift', 'poolside_summer', 'cabin_cozy', 'morning_ritual', 'locker_room_energy', 'spec_sheet', 'flat_lay_kitchen', 'pet_companion', 'street_session', 'desk_setup', 'train_window_passage', 'day_with_five_hours', 'after_dark_montage', 'hotel_edit_offer', 'snow_silent_film', 'cup_holder_deadpan', 'myth_fact_label', 'first_light_bumper', 'six_atelier_chapters', 'quiet_nursery_ritual', 'two_voices_dialogue', 'four_elements_proof', 'ferry_deck_wind', 'offer_sandwich_sprint', 'eclipse_teaser_drop', 'split_blink_bumper', 'social_proof_converter', 'flash_drop_promo', 'spec_showcase_reel'.
Optional conversion button pill copy rendered on cta_endcard blocks (e.g., 'SHOP THE COLLECTION'). Costs 0 AI render credits.
Optional public HTTP/HTTPS URL of a PNG/SVG/WebP brand logo to center on the stark black-screen logo_outro slate.
Standard storyboard template (used when 'recipe' and 'blocks' are omitted): 'problem-solution' (4 beats, ~20s), 'ugc-testimonial' (4 beats, ~20s), 'product-feature' (3 beats, ~15s), 'unboxing' (3 beats, ~15s), or 'single' (1 beat, 5s).
Number of parallel creative variants to render (1 to 3).
Public HTTP/HTTPS URL of the source product photo (JPG, PNG, or WebP).
Brand wordmark rendered on the final stark #000000 black-screen logo_outro slate (e.g., 'CHANEL'). Costs 0 AI render credits.
Synthesized background audio score mixed into Director Recipes: 'nyc_dusk', 'luxury_ambient', 'modern_pulse', or 'none'.
Editorial brand headline rendered on the deterministic text_card intertitle (e.g., 'TIMELESS IN MOTION'). Costs 0 AI render credits.
Base64-encoded product image data (alternative to image_url).
Optional secondary subtitle rendered beneath brand_text on text_card blocks (e.g., 'NEW YORK · AUTUMN / WINTER').
Optional array of custom motion prompts corresponding to each ai_scene block in a recipe.
Optional ID of an already-completed Vadyu video to reuse its verified 5s AI motion scene(s) while re-stitching new deterministic cards, copy, logo, CTA, or audio for 0 new AI render credits in ~5 seconds.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 25, 2026.
Generate a commercial AI product video ad from a product photo URL (image_url) or base64 image (image_base64). Supports both API v2 Director Recipes (53 presets such as nyc_luxury, minimal_cinema, dtc_story and editorial_flagship, or custom blocks[] combining AI motion scenes, deterministic brand messaging typography cards, synthesized background audio scores, and stark #000000 black-screen brand logo slates) and multi-beat storyboards (problem-solution, ugc-testimonial, product-feature, unboxing, single) in 9:16, 1:1, 16:9, or 4:5. Deterministic text_card and logo_outro blocks consume 0 AI render credits.
| Argument | Type | Description |
|---|---|---|
| theme | object | Optional RecipeTheme override for typography cards, captions, CTA frames, split dividers, safe zones, and default transitions. |
| blocks | array | Optional custom API v2 composable timeline (2 to 20 blocks; must include at least 1 'ai_scene' block). Deterministic 'text_card', 'ken_burns_still', 'flash_cut_intro', 'cta_endcard', 'split_before_after', and 'logo_outro' blocks cost 0 render credits. |
| format | string | Aspect ratio: '9:16' (Reels/TikTok/Shorts), '1:1' (Square), '16:9' (YouTube/Web), '4:5' (Meta Feed). |
| prompt | string | Optional camera motion and lighting direction (e.g., 'Slow 360 studio turntable rotation with warm golden rim lighting, crisp product label'). |
| recipe | string | Optional API v2 Director Recipe preset id. Signature presets: 'nyc_luxury' (NYC cab cameo + brand card + black logo, 14.5s, 2 renders), 'minimal_cinema' (hero + brand card + logo, 9.5s, 1 render), 'dtc_story' (creator hook + value card + lifestyle + logo, 14.5s, 2 renders), 'editorial_flagship' (7 cuts, 20.7s, 2 renders). Recipe Foundry presets (call vadyu_list_recipes for timelines, tags and themes): 'brand_sting_bumper', 'museum_plinth', 'silent_manifesto', 'clinical_clean', 'proof_first_split', 'offer_first_anchor', 'countdown_drop', 'three_reasons', 'pov_it_arrived', 'grand_campaign_12', 'founders_letter', 'craft_documentary', 'film_noir', 'levitation_dream', 'retro_rewind', 'unboxing_asmr', 'rainy_paris_cafe', 'night_drive_neon', 'desert_light', 'greenhouse_botanical', 'holiday_gift', 'poolside_summer', 'cabin_cozy', 'morning_ritual', 'locker_room_energy', 'spec_sheet', 'flat_lay_kitchen', 'pet_companion', 'street_session', 'desk_setup', 'train_window_passage', 'day_with_five_hours', 'after_dark_montage', 'hotel_edit_offer', 'snow_silent_film', 'cup_holder_deadpan', 'myth_fact_label', 'first_light_bumper', 'six_atelier_chapters', 'quiet_nursery_ritual', 'two_voices_dialogue', 'four_elements_proof', 'ferry_deck_wind', 'offer_sandwich_sprint', 'eclipse_teaser_drop', 'split_blink_bumper', 'social_proof_converter', 'flash_drop_promo', 'spec_showcase_reel'. |
| cta_text | string | Optional conversion button pill copy rendered on cta_endcard blocks (e.g., 'SHOP THE COLLECTION'). Costs 0 AI render credits. |
| logo_url | string | Optional public HTTP/HTTPS URL of a PNG/SVG/WebP brand logo to center on the stark black-screen logo_outro slate. |
| sequence | string | Standard storyboard template (used when 'recipe' and 'blocks' are omitted): 'problem-solution' (4 beats, ~20s), 'ugc-testimonial' (4 beats, ~20s), 'product-feature' (3 beats, ~15s), 'unboxing' (3 beats, ~15s), or 'single' (1 beat, 5s). |
| variants | integer | Number of parallel creative variants to render (1 to 3). |
| image_url | string | Public HTTP/HTTPS URL of the source product photo (JPG, PNG, or WebP). |
| logo_text | string | Brand wordmark rendered on the final stark #000000 black-screen logo_outro slate (e.g., 'CHANEL'). Costs 0 AI render credits. |
| audio_mood | string | Synthesized background audio score mixed into Director Recipes: 'nyc_dusk', 'luxury_ambient', 'modern_pulse', or 'none'. |
| brand_text | string | Editorial brand headline rendered on the deterministic text_card intertitle (e.g., 'TIMELESS IN MOTION'). Costs 0 AI render credits. |
| image_base64 | string | Base64-encoded product image data (alternative to image_url). |
| brand_subtext | string | Optional secondary subtitle rendered beneath brand_text on text_card blocks (e.g., 'NEW YORK · AUTUMN / WINTER'). |
| scene_prompts | array | Optional array of custom motion prompts corresponding to each ai_scene block in a recipe. |
| reuse_video_id | number | Optional ID of an already-completed Vadyu video to reuse its verified 5s AI motion scene(s) while re-stitching new deterministic cards, copy, logo, CTA, or audio for 0 new AI render credits in ~5 seconds. |
{
"type": "object",
"properties": {
"theme": {
"type": "object",
"properties": {
"safeZone": {
"enum": [
"standard",
"reels_tiktok"
],
"type": "string",
"description": "'reels_tiktok' lifts lower-third captions and CTA pills above vertical social UI chrome."
},
"fontStyle": {
"enum": [
"serif_luxury",
"sans_modern",
"mono_editorial"
],
"type": "string"
},
"accentColor": {
"type": "string",
"description": "Hex accent color (#RRGGBB) for rules, subcaptions, CTA border, and split divider."
},
"backgroundColor": {
"type": "string",
"description": "Dark hex background color (#RRGGBB, relative luminance < 0.12) for text and CTA cards."
},
"defaultTransition": {
"enum": [
"hard_cut",
"fade_black",
"flash_white"
],
"type": "string"
}
},
"description": "Optional RecipeTheme override for typography cards, captions, CTA frames, split dividers, safe zones, and default transitions."
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"role": {
"type": "string"
},
"type": {
"enum": [
"ai_scene",
"text_card",
"ken_burns_still",
"flash_cut_intro",
"cta_endcard",
"split_before_after",
"rating_social_proof",
"promo_urgency_slate",
"feature_callout_grid",
"logo_outro"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string",
"description": "Camera/scene motion prompt (for ai_scene blocks)."
},
"caption": {
"type": "string",
"description": "Optional lower-third caption overlay (for ai_scene and ken_burns_still blocks)."
},
"cta_text": {
"type": "string",
"description": "CTA button pill label (for cta_endcard blocks)."
},
"headline": {
"type": "string",
"description": "Headline or review quote text (for text_card, cta_endcard, split_before_after, rating_social_proof, promo_urgency_slate, and feature_callout_grid blocks)."
},
"logo_text": {
"type": "string",
"description": "Brand logo text (for logo_outro blocks)."
},
"promo_code": {
"type": "string",
"description": "Promo / coupon code (for promo_urgency_slate blocks, e.g. 'VADYU20')."
},
"subcaption": {
"type": "string",
"description": "Optional accent-colored lower-third subcaption (for ai_scene and ken_burns_still blocks)."
},
"transition": {
"enum": [
"hard_cut",
"fade_black",
"flash_white"
],
"type": "string",
"description": "Per-block entry transition override."
},
"after_label": {
"type": "string",
"description": "Right panel badge label (for split_before_after blocks, default 'AFTER')."
},
"subheadline": {
"type": "string",
"description": "Subheadline, reviewer badge, urgency window, or feature list text (for text_card, cta_endcard, split_before_after, rating_social_proof, promo_urgency_slate, and feature_callout_grid blocks)."
},
"before_label": {
"type": "string",
"description": "Left panel badge label (for split_before_after blocks, default 'BEFORE')."
},
"duration_sec": {
"type": "number",
"description": "Duration in seconds (5s for ai_scene; 1-8s for cards/stills/splits/logo; 0.6-5s for flash_cut_intro)."
},
"rating_stars": {
"type": "number",
"description": "Star rating from 1 to 5 (for rating_social_proof blocks, default 5)."
},
"discount_badge": {
"type": "string",
"description": "Discount badge pill (for promo_urgency_slate blocks, e.g. '20% OFF')."
},
"feature_bullets": {
"type": "array",
"items": {
"type": "string"
},
"description": "3 feature/benefit specification callout bullets (for feature_callout_grid blocks)."
}
}
},
"description": "Optional custom API v2 composable timeline (2 to 20 blocks; must include at least 1 'ai_scene' block). Deterministic 'text_card', 'ken_burns_still', 'flash_cut_intro', 'cta_endcard', 'split_before_after', and 'logo_outro' blocks cost 0 render credits."
},
"format": {
"enum": [
"9:16",
"1:1",
"16:9",
"4:5"
],
"type": "string",
"default": "9:16",
"description": "Aspect ratio: '9:16' (Reels/TikTok/Shorts), '1:1' (Square), '16:9' (YouTube/Web), '4:5' (Meta Feed)."
},
"prompt": {
"type": "string",
"description": "Optional camera motion and lighting direction (e.g., 'Slow 360 studio turntable rotation with warm golden rim lighting, crisp product label')."
},
"recipe": {
"enum": [
"nyc_luxury",
"minimal_cinema",
"dtc_story",
"editorial_flagship",
"brand_sting_bumper",
"museum_plinth",
"silent_manifesto",
"clinical_clean",
"proof_first_split",
"offer_first_anchor",
"countdown_drop",
"three_reasons",
"pov_it_arrived",
"grand_campaign_12",
"founders_letter",
"craft_documentary",
"film_noir",
"levitation_dream",
"retro_rewind",
"unboxing_asmr",
"rainy_paris_cafe",
"night_drive_neon",
"desert_light",
"greenhouse_botanical",
"holiday_gift",
"poolside_summer",
"cabin_cozy",
"morning_ritual",
"locker_room_energy",
"spec_sheet",
"flat_lay_kitchen",
"pet_companion",
"street_session",
"desk_setup",
"train_window_passage",
"day_with_five_hours",
"after_dark_montage",
"hotel_edit_offer",
"snow_silent_film",
"cup_holder_deadpan",
"myth_fact_label",
"first_light_bumper",
"six_atelier_chapters",
"quiet_nursery_ritual",
"two_voices_dialogue",
"four_elements_proof",
"ferry_deck_wind",
"offer_sandwich_sprint",
"eclipse_teaser_drop",
"split_blink_bumper",
"social_proof_converter",
"flash_drop_promo",
"spec_showcase_reel"
],
"type": "string",
"description": "Optional API v2 Director Recipe preset id. Signature presets: 'nyc_luxury' (NYC cab cameo + brand card + black logo, 14.5s, 2 renders), 'minimal_cinema' (hero + brand card + logo, 9.5s, 1 render), 'dtc_story' (creator hook + value card + lifestyle + logo, 14.5s, 2 renders), 'editorial_flagship' (7 cuts, 20.7s, 2 renders). Recipe Foundry presets (call vadyu_list_recipes for timelines, tags and themes): 'brand_sting_bumper', 'museum_plinth', 'silent_manifesto', 'clinical_clean', 'proof_first_split', 'offer_first_anchor', 'countdown_drop', 'three_reasons', 'pov_it_arrived', 'grand_campaign_12', 'founders_letter', 'craft_documentary', 'film_noir', 'levitation_dream', 'retro_rewind', 'unboxing_asmr', 'rainy_paris_cafe', 'night_drive_neon', 'desert_light', 'greenhouse_botanical', 'holiday_gift', 'poolside_summer', 'cabin_cozy', 'morning_ritual', 'locker_room_energy', 'spec_sheet', 'flat_lay_kitchen', 'pet_companion', 'street_session', 'desk_setup', 'train_window_passage', 'day_with_five_hours', 'after_dark_montage', 'hotel_edit_offer', 'snow_silent_film', 'cup_holder_deadpan', 'myth_fact_label', 'first_light_bumper', 'six_atelier_chapters', 'quiet_nursery_ritual', 'two_voices_dialogue', 'four_elements_proof', 'ferry_deck_wind', 'offer_sandwich_sprint', 'eclipse_teaser_drop', 'split_blink_bumper', 'social_proof_converter', 'flash_drop_promo', 'spec_showcase_reel'."
},
"cta_text": {
"type": "string",
"description": "Optional conversion button pill copy rendered on cta_endcard blocks (e.g., 'SHOP THE COLLECTION'). Costs 0 AI render credits."
},
"logo_url": {
"type": "string",
"description": "Optional public HTTP/HTTPS URL of a PNG/SVG/WebP brand logo to center on the stark black-screen logo_outro slate."
},
"sequence": {
"enum": [
"problem-solution",
"ugc-testimonial",
"product-feature",
"unboxing",
"single"
],
"type": "string",
"default": "problem-solution",
"description": "Standard storyboard template (used when 'recipe' and 'blocks' are omitted): 'problem-solution' (4 beats, ~20s), 'ugc-testimonial' (4 beats, ~20s), 'product-feature' (3 beats, ~15s), 'unboxing' (3 beats, ~15s), or 'single' (1 beat, 5s)."
},
"variants": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1,
"description": "Number of parallel creative variants to render (1 to 3)."
},
"image_url": {
"type": "string",
"description": "Public HTTP/HTTPS URL of the source product photo (JPG, PNG, or WebP)."
},
"logo_text": {
"type": "string",
"description": "Brand wordmark rendered on the final stark #000000 black-screen logo_outro slate (e.g., 'CHANEL'). Costs 0 AI render credits."
},
"audio_mood": {
"enum": [
"nyc_dusk",
"luxury_ambient",
"modern_pulse",
"none"
],
"type": "string",
"description": "Synthesized background audio score mixed into Director Recipes: 'nyc_dusk', 'luxury_ambient', 'modern_pulse', or 'none'."
},
"brand_text": {
"type": "string",
"description": "Editorial brand headline rendered on the deterministic text_card intertitle (e.g., 'TIMELESS IN MOTION'). Costs 0 AI render credits."
},
"image_base64": {
"type": "string",
"description": "Base64-encoded product image data (alternative to image_url)."
},
"brand_subtext": {
"type": "string",
"description": "Optional secondary subtitle rendered beneath brand_text on text_card blocks (e.g., 'NEW YORK · AUTUMN / WINTER')."
},
"scene_prompts": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional array of custom motion prompts corresponding to each ai_scene block in a recipe."
},
"reuse_video_id": {
"type": "number",
"description": "Optional ID of an already-completed Vadyu video to reuse its verified 5s AI motion scene(s) while re-stitching new deterministic cards, copy, logo, CTA, or audio for 0 new AI render credits in ~5 seconds."
}
}
}Check the authenticated user's active Vadyu subscription plan, remaining monthly render credits, total render quota, and generation eligibility.
No arguments.
{
"type": "object",
"properties": {}
}Poll the rendering status, beat progress, recipe block timeline, coherence score, signed MP4 download URL (video_url), and ready-to-publish Campaign Bundle of one or more generated Vadyu video ads by numeric video_id or batch video_ids[].
| Argument | Type | Description |
|---|---|---|
| video_id | integer | Numeric video ID returned by vadyu_generate_video_ad. |
| video_ids | array | Optional batch of numeric video IDs (e.g. from a copy_variants[] matrix render) to poll and aggregate in a single call. |
{
"type": "object",
"properties": {
"video_id": {
"type": "integer",
"description": "Numeric video ID returned by vadyu_generate_video_ad."
},
"video_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Optional batch of numeric video IDs (e.g. from a copy_variants[] matrix render) to poll and aggregate in a single call."
}
}
}List all 53+ unified Composable Director Recipes (signature presets plus the Recipe Foundry catalog, each with collection, tags and theme), custom block schemas (ai_scene, text_card, logo_outro, ken_burns_still, flash_cut_intro, cta_endcard, split_before_after), synthesized audio moods (nyc_dusk, luxury_ambient, modern_pulse, none), credit rules, and optional smart recipe recommendations.
| Argument | Type | Description |
|---|---|---|
| max_credits | number | Optional maximum AI render credits per ad (e.g., 1 or 2) when filtering recommendations. |
| recommend_for | string | Optional product or fashion/portrait description (e.g., 'Tall Swedish blonde supermodel on a golden runway' or 'Matte black chronograph watch'). When provided, returns the top 3 ranked recipe recommendations with pre-filled suggested_payload. |
{
"type": "object",
"properties": {
"max_credits": {
"type": "number",
"description": "Optional maximum AI render credits per ad (e.g., 1 or 2) when filtering recommendations."
},
"recommend_for": {
"type": "string",
"description": "Optional product or fashion/portrait description (e.g., 'Tall Swedish blonde supermodel on a golden runway' or 'Matte black chronograph watch'). When provided, returns the top 3 ranked recipe recommendations with pre-filled suggested_payload."
}
}
}List all supported Vadyu multi-beat ad sequences (storyboards), Composable Director Recipes, audio moods, and aspect ratio formats along with beat counts, durations, and prompt best practices.
No arguments.
{
"type": "object",
"properties": {}
}List generated video ads in the authenticated Vadyu account, with optional status filtering ('done', 'processing', 'failed') and pagination.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| limit | integer | Number of videos to return per page (1-50, default 10). |
| status | string | Optional filter by rendering status. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Number of videos to return per page (1-50, default 10)."
},
"status": {
"enum": [
"done",
"processing",
"failed"
],
"type": "string",
"description": "Optional filter by rendering status."
}
}
}Submit a new custom ad recipe idea, multi-scene storyline blueprint, or product feedback to Vadyu's creative engineering team.
| Argument | Type | Description |
|---|---|---|
| title | string | Short name for the proposed recipe (e.g., 'Parisian Cafe Espresso Reveal'). |
| logo_text | string | Optional example brand logo slate text. |
| storyline* | string | Scene-by-scene storyline description (e.g., 'Scene 1: Steam rising off product -> Text card: MORNING RITUAL -> Scene 2: Woman at cafe table -> Black screen logo + warm jazz chord'). |
| audio_mood | string | Preferred background audio mood. |
| brand_text | string | Optional example brand messaging intertitle text. |
{
"type": "object",
"required": [
"storyline"
],
"properties": {
"title": {
"type": "string",
"description": "Short name for the proposed recipe (e.g., 'Parisian Cafe Espresso Reveal')."
},
"logo_text": {
"type": "string",
"description": "Optional example brand logo slate text."
},
"storyline": {
"type": "string",
"description": "Scene-by-scene storyline description (e.g., 'Scene 1: Steam rising off product -> Text card: MORNING RITUAL -> Scene 2: Woman at cafe table -> Black screen logo + warm jazz chord')."
},
"audio_mood": {
"enum": [
"nyc_dusk",
"luxury_ambient",
"modern_pulse",
"none"
],
"type": "string",
"description": "Preferred background audio mood."
},
"brand_text": {
"type": "string",
"description": "Optional example brand messaging intertitle text."
}
}
}