muapi Logomuapi Logo
muapi Logomuapi Logo

Volcengine Video Lip Sync API: AI Video Editing

Edit and transform videos with Volcengine Video Lip Sync via the Muapi REST API. Pay per generation — no subscription needed.

Volcengine Video Lip Sync API Reference

Endpoint

POST https://api.muapi.ai/api/v1/volcengine-video-to-video-lip-sync

Submit a job with your MuApi API key in the x-api-key header, then poll https://api.muapi.ai/api/v1/predictions/{request_id}/result until status is completed.

Parameters

NameTypeRequiredDescription
modestringYesService mode. 'lite' is for single-person frontal videos with faster processing. 'basic' is for single-person complex scenes, supporting scene segmentation and speaker identification.Options: lite, basicDefault: "lite"
audio_urlstringYesTarget pure vocal audio URL used to drive the video's lip movements. Max file size: 10MB.
video_urlstringYesVideo URL. Supported resolution: 360p-1080p. Videos above 1080p are compressed to 1080p; below 360p is not supported. Supported formats: MOV, MP4, HDR. Max file size: 500MB.
align_audiobooleanNoSupported in Lite mode. Whether to loop the video when the audio is longer than the video.Default: true
open_scenedetbooleanNoEnable scene segmentation and speaker identification. Only supported in Basic mode.Default: false
separate_vocalbooleanNoEnable vocal separation to suppress background noise.Default: false
align_audio_reversebooleanNoSupported in Lite mode. Whether to loop the video in reverse (backward). Requires align_audio to be true.Default: false
templ_start_secondsintNoSupported in Lite mode. Start time of the template video, in seconds.Default: 0

cURL example

REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/volcengine-video-to-video-lip-sync \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"lite","video_url":"https://example.com/your-video_url","audio_url":"https://example.com/your-audio_url"}' | jq -r .request_id)

curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY"

Python example

import os, time, requests

API = "https://api.muapi.ai/api/v1"
headers = {"x-api-key": os.environ["MUAPI_API_KEY"]}

r = requests.post(f"{API}/volcengine-video-to-video-lip-sync", headers=headers, json={"mode":"lite","video_url":"https://example.com/your-video_url","audio_url":"https://example.com/your-audio_url"})
request_id = r.json()["request_id"]

while True:
    res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json()
    if res["status"] == "completed":
        print(res["outputs"]); break
    if res["status"] == "failed":
        raise RuntimeError(res.get("error"))
    time.sleep(3)

Full docs and agent/MCP integration: llms.txt. Get an API key at muapi.ai/access-keys.