Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEY
Parameters
model string required
Model ID to use for the request.
Value: ultra_lipsync
mode string required
Generation mode.
Options: text2video (text to video), audio2video (audio to video)
video_url string
Video URL (mutually exclusive with video_id). Must be a valid HTTP or HTTPS URL.
text string required
Text content (required for text2video mode), maximum length 120 characters.
voice_language string required
Voice language (required for text2video mode).
Options: zh (Chinese), en (English)
voice_id string required
Voice ID (required for text2video mode).
voice_speed number
Voice speed.
Default: 1.0
Range: 0.8 - 2.0
audio_url string required
Audio URL (required for audio2video mode). Must be a valid HTTP or HTTPS URL.
Error Codes
| Code | Description |
|---|---|
| 401 | API key is missing or invalid |
| 403 | Insufficient balance or permission denied |
| 429 | Rate limit exceeded |
| 500 | Internal server error |