# LipSync 2.0 ## --- TAB: API Reference --- POST https://api.newportai.com/api/async/lipsync/2.0

The LipSync 2.0 API is an asynchronous audio-to-video synchronization service designed to precisely align specified audio with character lip movements. Compared to the previous version, this upgrade significantly improves output clarity and resolution.

Submit a POST request to the LipSync 2.0 API to obtain a taskId.
Submit a POST request to the Polling API to retrieve the synchronization results.
Configure a Callback URL to receive results automatically on completion.

## Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

## Request Body

srcVideoUrl string Required

The URL of the source video.

audioUrl string Required

The URL of the original audio. If the billing duration cannot be determined from this file, the task will fail.

videoParams object

video_width integer Required

Specifies the width of the output video. If set to 0, the output will maintain the source video's width.

video_height integer Required

Specifies the height of the output video. If set to 0, the output will maintain the source video's height.

video_enhance integer Required

Enables facial clarity and sharpness enhancement: 0 for disabled, 1 for enabled.

fps stringOptional

Specifies the frame rate (Default: 25 fps). Use "original" to match the input video(capped at 60 fps).
Billing: If set to "original", the cost scales from the base 2 credits/s to: (input FPS / 25) * 2 credits/s.

## Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

## Errors

10192Illegal param

## Polling

Use the Polling API to retrieve the processing results.

## Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

### 0 Task Completed ```json { "code": 0, "message": "success", "data": { "task": { "taskId": "a2ec2894eed947e2a17cee86e858da17", "status": 3, "executionTime": 17232, "expire": 1769586737611, "taskType": "lipsync/2.0" }, "videos": [ { "videoType": "mp4", "videoUrl": "https://dreamface-resource-aigc.oss-us-east-1.aliyuncs.com/dreamapi/o/2026-01-26/f19ec50fc7ca418aafa918f57298ce76.mp4" } ] } } ``` ### 0 Task Processing ```json { "code": 0, "message": "success", "data": { "task": { "taskId": "b08337dc08d7428daa64b3d5e61b8350", "status": 2, }, } } ``` ## Code Examples ```curl curl -X POST 'https://api.newportai.com/api/async/lipsync/2.0' \ -H "Authorization: Bearer {{key}}" \ -H 'Content-Type: application/json' \ -d '{ "srcVideoUrl": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4", "audioUrl": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/AoOVLxqINsl1dTAAhnmAW.wav", "videoParams": { "video_width": 0, "video_height": 0, "video_enhance": 1 } }' ``` ```java HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.newportai.com/api/async/lipsync/2.0")) .header("Content-Type", "application/json") .header("Authorization", "Bearer {{key}}") .POST(HttpRequest.BodyPublishers.ofString("{\"srcVideoUrl\":\"https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4\",\"audioUrl\":\"https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/AoOVLxqINsl1dTAAhnmAW.wav\",\"videoParams\":{\"video_width\":0,\"video_height\":0,\"video_enhance\":1}}")) .build(); HttpResponse res = client.send(request, HttpResponse.BodyHandlers.ofString()); ``` ```python import requests response = requests.post( "https://api.newportai.com/api/async/lipsync/2.0", headers={ "Content-Type": "application/json", "Authorization": "Bearer {{key}}" }, json={ "srcVideoUrl": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4", "audioUrl": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/AoOVLxqINsl1dTAAhnmAW.wav", "videoParams": {"video_width": 0, "video_height": 0, "video_enhance": 1} } ) print(response.json()) ``` ## Response Example ### 0 Successful ```json { "code": 0, "message": "success", "data": { "taskId": "a2ec2894eed947e2a17cee86e858da17" } } ``` ### 10192 Illegal param ```json { "code": 10192, "message": "illegal param" } ``` ## --- TAB: Playground --- ## --- TAB: Pricing --- ## Video FPS Billing Overview | Billing Mode | FPS Handling | Credit Cost (per second) | Cost Behavior | | :----------- | :----------- | :----------------------- | :------------ | | Limit 25 FPS | Limit 25fps | 2 credits / second | Flat cost | | Original FPS| Use a custom output frame rate (capped at 60 fps) | Input FPS ÷ 25 * 2 credits / second | Scales linearly with FPS | ## Credit Examples by FPS | Input FPS | Billing Mode | Credits / Second | | :-------- | :----------- | :--------------- | | 25 FPS | Limit 25 FPS | 2.0 | | 30 FPS | Limit 25 FPS | 2.0 | | 25 FPS | Original FPS | 2.0 | | 60 FPS | Original FPS | 4.8 | - [View Full Pricing Page](/pricing) - [Contact us](/contact)

LipSync 2.0

Creation History