Create Lipsync
Replaces the audio on an existing video and re-animates the speaker’s lip movements to match the new audio. Use mode: ‘speed’ for fast output or ‘precision’ for high-quality lip-sync.
Documentation Index
Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Headers
Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.
1 - 255^[A-Za-z0-9_\-:.]{1,255}$Body
Request body for POST /v3/lipsyncs.
Asset input via publicly accessible HTTPS URL.
- AssetUrl
- AssetId
Asset input via publicly accessible HTTPS URL.
- AssetUrl
- AssetId
Title for the lipsync job
Quality mode: 'speed' (faster) or 'precision' (higher quality, uses avatar inference)
speed, precision Webhook URL for completion notifications
ID included in webhook payload
Generate captions for the output video
Preserve the source video's encoding specs (resolution, bitrate).
Allow dynamic duration adjustment
Remove background music
Enhance speech quality
Add watermark to output
Start time in seconds for partial lipsync
End time in seconds for partial lipsync
Frame rate mode: 'vfr', 'cfr', or 'passthrough'.
Project/folder ID to organize lipsync into
Response
Successful response
Response for POST /v3/lipsyncs.

