---
title: "Latent Sync - Lip-sync video generation"
method: POST
path: "/v1/ai/lip-sync/latent-sync"
tags: ["lip-sync"]
---

# Latent Sync - Lip-sync video generation

`POST /v1/ai/lip-sync/latent-sync`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/lip-sync/latent-sync`
- Auth: API key in header `x-magnific-api-key`

Generate lip-synced video by synchronizing a video with an audio file using AI Latent-Sync technology

## Request body

- Request
  - `video_url` string, required: URL of the video to sync
  - `audio_url` string, required: URL of the audio to sync
  - `seed` integer: Seed for the syncing process
  - `guidance_scale` number, float: Guidance strength for the sync process
  - `return_private_url` boolean: If true, the private URL (gs URI) of the generated video will be returned
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)