{"uid":"cap__kRfL-BkiJyiX8Ap5_dsR","slug":"agents-vimmerse-net-vimmerse-lip-sync-video-81c35bce","name":"Vimmerse Lip-Sync Video","description":"Lip-sync using URLs only.\n\n**Provide:**\n- Visual: **`image_url`** and/or **`video_url`**\n- Audio: **`audio_url`**, **or** **`prompt`** + **`voice`** for TTS\n\n**`option`:** `AutoLipSync`, `SyncLipSync`, `HummingBird`, `NewportLipSync`, `KlingAvatar`, `PVideo`, `NewportDreamAvatar`\n\n```python\nimport requests\n\nr = requests.post(\n    \"https://api.vimmerse.net/v2/video/lip-sync\",\n    headers={\"X-Api-Key\": \"YOUR_API_KEY\", \"Content-Type\": \"application/json\"},\n    json={\n        \"image_url\": \"https://…/face.png\",\n        \"audio_url\": \"https://…/speech.mp3\",\n        \"option\": \"AutoLipSync\",\n        \"async_mode\": True,\n    },\n    timeout=60,\n)\nprint(r.json())\n```","url":"https://agents.vimmerse.net/v2/video/lip-sync?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"LipSyncRequest","properties":{"voice":{"type":"string","title":"Narrator voice","default":"AutoV"},"option":{"type":"string","title":"Option","default":"AutoLipSync","description":"`AutoLipSync`, `SyncLipSync`, `HummingBird`, `NewportLipSync`, `KlingAvatar`, `PVideo`, `NewportDreamAvatar`."},"prompt":{"type":"string","title":"Prompt","default":"","description":"Speech prompt when generating audio from text."},"audio_url":{"type":"string","title":"Audio URL","default":""},"image_url":{"type":"string","title":"Image URL","default":""},"video_url":{"type":"string","title":"Video URL","default":""},"async_mode":{"type":"boolean","title":"Async Mode","default":false},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL"},"audio_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Audio duration (seconds)"},"video_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Video duration (seconds)"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"1.2","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"dynamic","summary":"$1.2/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1.2","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EIHSP8GheIlzZwFh_XD35","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1.2","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Animates a face image or video to match provided or TTS-generated audio, producing a lip-synced video output.","exampleAgentPrompt":"Take this portrait photo at https://cdn.example.com/face.png and this audio file at https://cdn.example.com/speech.mp3, and generate a lip-synced talking head video using the AutoLipSync option — run it asynchronously and notify me when it's done.","exampleUseCases":[{"title":"Personalized e-learning narrator avatar","prompt":"I have a headshot of our instructor at https://cdn.school.com/instructor.jpg and a pre-recorded lecture audio at https://cdn.school.com/lecture.mp3 — can you create a lip-synced talking head video using AutoLipSync in async mode so we can embed it in our course?"},{"title":"AI spokesperson for marketing video","prompt":"Use this brand ambassador photo at https://assets.brand.com/spokesperson.png and animate it to lip-sync with the voiceover at https://assets.brand.com/promo.mp3 using the SyncLipSync option — I need this as a polished video ad."},{"title":"Multilingual dubbed avatar from text","prompt":"I have a face image at https://media.example.com/avatar.png and I want you to generate the speech from the text 'Welcome to our platform, we are happy to have you' using the AutoV voice, then lip-sync the avatar to it using KlingAvatar option asynchronously."}],"resultDescription":"Returns a job or asset ID (in async mode) that can be polled via the Get Asset endpoint until the lip-synced video is ready, or returns the completed video asset details and URL directly if run synchronously.","failureModes":["Invalid or inaccessible image_url/video_url/audio_url — returns an error if the URL is unreachable or not a supported format","Neither audio_url nor prompt provided — request lacks audio input","Neither image_url nor video_url provided — no visual input supplied","Unsupported option value — returns validation error if option string is not one of the allowed enum values","Insufficient credits — returns 402 Payment Required if account balance is too low","Timeout on synchronous mode for long audio — long jobs may time out; async_mode recommended","Webhook delivery failure — if webhook_url is unreachable, notification is lost but job may still complete"],"whenToPreferThis":"Choose this endpoint when you need to animate a static face image or existing video to match a specific audio track (or TTS-generated speech), especially when you want multiple lip-sync engine options (AutoLipSync, SyncLipSync, KlingAvatar, etc.) to trade off quality and speed. Prefer this over text-to-video endpoints when the core requirement is accurate mouth/lip synchronization rather than full scene generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:39:22.865Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-lip-sync-video-81c35bce"}