Why use Reusable LipSync API?
The Reusable LipSync API is an optimized version of our LipSync API, designed for developers who frequently generate lip-synced videos using the same visual reference.What’s Different?
| Feature | LipSync API | Reusable LipSync API |
|---|---|---|
| Reference upload | Required for each request | Upload once, reuse multiple times |
| Training step | Required | Not required |
| Input for generation | Reference + audio | Audio only (reference reused) |
| Generation speed | Standard | Much faster (no retraining) |
| Cost per request | 5 points base + 5 points per minute | 5 points per minute |
How it works
1
Create a model using the previous task ID
Create a reusable lipsync model using previous task ID from lipsync API in precision mode.
2
Host your audio assets at a publicly accessible URL
Upload your audio file so our servers can retrieve them.
3
Send an API request with the appropriate parameters
Reference your hosted assets and specify your desired mode (Standard or
Precision).
4
Wait or query status
Use our webhook callback or poll the API with your job ID until processing
is complete.
5
Download video output
Retrieve the finished talking photo or lip‑synced video from the provided
URL.
Usage Limitation:
- You may have up to 10 concurrent jobs (including queued requests).
- Estimated queue time: 1–120 minutes, depending on system load.
- Processing time: ~10 minutes.
If a video or photo contains multiple faces, only the largest detected face
will be lip‑synced.
Model Expiration Policy
Models created via the Model Creation API have an automatic expiration mechanism based on activity.Rules
- Default Expiration Period Each reusable lipsync model remains active for 3 months from its creation date or last usage.
- Automatic Extension Every time the reusable lipsync model is used (e.g., called in a reusable lipsync api request), its expiration date is extended by another 3 months from that point in time.
- Expiration If a reusable lipsync model is not used for 3 consecutive months, it will automatically expire and may be deleted permanently.
- Reactivation Expired reusable lipsync models cannot be reactivated. To continue using the same configuration, you must resubmit the lipsync job and recreate reusable lipsync model through the API.
API Error Codes
| Code | Description |
|---|---|
| 5 | Invalid request parameters. |
| 7 | No permission to request. |
| 104 | Insufficient credits. |
| 814 | Your account is not a member and is not allowed to call the API. |
| 1000 | Internal Server Error. |
| 1301 | Callback Challenge failed. |
| 1302 | API key has been revoked. |
| 1304 | API key has reached the maximum number of concurrent requests. |
| 1502 | Your audio driver is either invalid or cannot be downloaded. |
| 1503 | Your account is not authorized to call the API. |
| 1504 | Task creation is not supported in Standard mode or for tasks from previous versions. |
| 1305 | Only business plan is allowed. |
| 1506 | Model is expired. |
Job Error Codes
| Code | Description |
|---|---|
| 999 | Failed to download the file. |
| 20611 | Video triggering flow limit. |