vadyu_generate_video_ad
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 (74 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| theme | No | Optional RecipeTheme override for typography cards, captions, CTA frames, split dividers, safe zones, and default transitions. | |
| blocks | No | 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 | No | Aspect ratio: '9:16' (Reels/TikTok/Shorts), '1:1' (Square), '16:9' (YouTube/Web), '4:5' (Meta Feed). | 9:16 |
| prompt | No | Optional camera motion and lighting direction (e.g., 'Slow 360 studio turntable rotation with warm golden rim lighting, crisp product label'). | |
| recipe | No | Optional Director Recipe preset id or 'auto' (automatically selects the highest-scoring recipe for your prompt). 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', 'lookbook_drop_promo', 'atelier_craft_specs', 'runway_press_acclaim', 'skincare_glow_transform', 'wardrobe_style_evolution', 'horology_craft_comparison', 'fragrance_notes_pyramid', 'signature_scent_acclaim', 'artisanal_pour_promo', 'hardware_titanium_specs', 'driver_cockpit_acclaim', 'launch_edition_drop', 'diamond_pave_specs', 'atelier_collector_acclaim', 'vault_allocation_drop', 'penthouse_gallery_specs', 'guest_sanctuary_acclaim', 'private_viewing_invite', 'athletic_biomech_specs', 'pro_athlete_acclaim', 'season_kit_drop'. | |
| cta_text | No | Optional conversion button pill copy rendered on cta_endcard blocks (e.g., 'SHOP THE COLLECTION'). Costs 0 AI render credits. | |
| logo_url | No | Optional public HTTP/HTTPS URL of a PNG/SVG/WebP brand logo to center on the stark black-screen logo_outro slate. | |
| sequence | No | 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). | problem-solution |
| variants | No | Number of parallel creative variants to render (1 to 3). | |
| image_url | No | Public HTTP/HTTPS URL of the source product photo (JPG, PNG, or WebP). | |
| logo_text | No | Brand wordmark rendered on the final stark #000000 black-screen logo_outro slate (e.g., 'CHANEL'). Costs 0 AI render credits. | |
| audio_mood | No | Synthesized background audio score mixed into Director Recipes: 'nyc_dusk', 'luxury_ambient', 'modern_pulse', or 'none'. | |
| brand_text | No | Editorial brand headline rendered on the deterministic text_card intertitle (e.g., 'TIMELESS IN MOTION'). Costs 0 AI render credits. | |
| image_base64 | No | Base64-encoded product image data (alternative to image_url). | |
| brand_subtext | No | Optional secondary subtitle rendered beneath brand_text on text_card blocks (e.g., 'NEW YORK · AUTUMN / WINTER'). | |
| scene_prompts | No | Optional array of custom motion prompts corresponding to each ai_scene block in a recipe. | |
| reuse_video_id | No | 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. | |
| recipe_variants | No | Optional multi-recipe A/B tournament matrix: pass 'auto_top_3' or an array of up to 5 recipe IDs (e.g. ['social_proof_converter', 'flash_drop_promo', 'spec_showcase_reel']). Combine with reuse_video_id to render 3 different Director Recipes on the same verified 5s AI scene for 0 AI render credits. |