Lip sync

Lip-sync a video to new audio

Replaces the speech of a video with your audio (a recording, a dub, a voice-over) and redraws the mouth to match. precision (the default, the best) or speed. Asynchronous. Needs your rights / consent declaration (consent).

Billing: Per second of the synced video, by mode (precision, the default / speed). Failed jobs are not charged. · Rate limit: 10/min · Asynchronous

post/v1/video/lipsync

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/video/lipsync
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

x-wait-msinteger

Wait for the job inside this call (ms)

Request body

mode'speed' | 'precision'

precision (the default) = frame-accurate, the best · speed = faster and cheaper, rougher

titlestring

Your name for this job (shown in your library)

audio_urlstring uri required

The new speech (mp3 / wav) — your recording, a voice-over from /v1/ai/voice or /v1/voices/speech

video_urlstring uri required

The original video (mp4 / webm)

consent_idstring

A consent you recorded before (the dashboard records one when you tick the box)

keep_formatboolean

Keep the source's resolution and bitrate

fit_to_audioboolean

Let the result's length follow the new audio

remove_musicboolean

Remove the background music from the result

enhance_speechboolean

Clean up the speech audio

duration_secondsnumber

The source's length if you know it (only for the estimate; the charge uses the real length)

Response

Completed (or 202 while processing)

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.