{"uid":"cap_rQt4rrk83wTjrJcY26ShI","slug":"agents-vimmerse-net-avatar-lip-sync-video-455af0cf","name":"Avatar Lip-Sync Video","description":"Creatify talking-avatar video. Provide **`avatar_id`**, **`voice_id`**, and **`prompt`**. Optional **`bg_image_url`**, **`audio_url`**, **`aspect_ratio`** (`1:1`, `16:9`, `9:16`), **`show_caption`** (`On`/`Off`).\n\nList avatars/voices via internal **GET** routes (not in public schema).","url":"https://agents.vimmerse.net/v2/video/avatars/lip-sync?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"AvatarLipSyncRequest","properties":{"prompt":{"type":"string","title":"Prompt","default":"","description":"Speech script for the avatar."},"voice_id":{"type":"string","title":"Voice ID","default":""},"audio_url":{"type":"string","title":"Background Audio URL","default":""},"avatar_id":{"type":"string","title":"Avatar ID","default":""},"async_mode":{"type":"boolean","title":"Async Mode","default":false},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL"},"aspect_ratio":{"type":"string","title":"Aspect Ratio","default":"16:9","description":"`1:1`, `16:9`, or `9:16`."},"bg_image_url":{"type":"string","title":"Background Image URL","default":""},"show_caption":{"type":"string","title":"Show Caption","default":"On","description":"`On` or `Off`."}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_kvOzmctIkgNU-GgUgFdM-","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Generates a talking-avatar video by syncing a selected avatar and voice to a provided speech script, with optional background image, captions, and aspect ratio.","exampleAgentPrompt":"Create a talking-avatar video using avatar ID 'av_male_001' and voice ID 'voice_en_us_02', with this script: 'Welcome to our platform — we make your ideas come to life.' Use a 16:9 aspect ratio, show captions, and use this background image: https://example.com/bg.jpg","exampleUseCases":[{"title":"Marketing spokesperson video","prompt":"Generate a talking-avatar video using avatar 'av_female_pro' and voice 'voice_en_us_01' with the script 'Discover our new product line this summer — quality you can trust.' Set it to 16:9 with captions on and this background: https://mybrand.com/studio-bg.jpg"},{"title":"Social media portrait clip","prompt":"Make a 9:16 vertical avatar video with avatar 'av_casual_01' and voice 'voice_en_uk_03' saying 'Hey! Don't miss our weekend flash sale — 30% off everything.' Turn captions on so viewers watching without sound can follow along."},{"title":"Multilingual e-learning intro","prompt":"Create a talking-avatar video with avatar 'av_trainer_02' and voice 'voice_es_mx_01' delivering this script: 'Bienvenidos al módulo de capacitación — vamos a comenzar.' Use a 1:1 square format with captions off and this slide as the background: https://elearn.example.com/slide1.png"}],"resultDescription":"Returns a video asset (or a job ID in async mode) representing the rendered talking-avatar clip, where the chosen avatar's mouth and face are lip-synced to the provided speech script using the selected voice, composed over the optional background image at the specified aspect ratio, with or without burned-in captions.","failureModes":["Invalid or unrecognized avatar_id — avatar not found or not accessible","Invalid or unrecognized voice_id — voice not available","Empty or missing prompt with no audio_url fallback — no speech content to sync","Invalid aspect_ratio value — must be '1:1', '16:9', or '9:16'","Unreachable bg_image_url or audio_url — network fetch failure","Insufficient credits — payment or credit balance too low","Async job failure — job ID returned but rendering fails downstream; must poll for status","Webhook delivery failure — webhook_url unreachable or returns non-200"],"whenToPreferThis":"Choose this endpoint when you need a talking-avatar video where a specific pre-built avatar persona speaks a custom script with lip-sync, especially for spokesperson content, marketing clips, e-learning, or social media. Prefer this over general video generation when avatar identity and lip-sync accuracy are the priority. Use async_mode with a webhook when rendering time is a concern for long scripts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:41:04.806Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-avatar-lip-sync-video-455af0cf"}