Video Translation API Overview

The resources (image, video, voice) generated by our API are valid for 7 days. Please save the relevant resources as soon as possible to prevent expiration.

Experience our video translation technology in action by exploring our interactive demo on GitHub: AKool Video Translation Demo.

API Endpoints

Translation Operations

Create Video Translation - Translate videos into multiple languages and lip-sync
Get Translation Result - Check processing status and retrieve translated video URLs

Resource Management

Get Language List - Get supported languages for translation

Getting Started

Basic Workflow

Get Available Languages:
- Use the Get Language List API to see all supported target languages
- Note which languages require specific voice IDs
Create Translation:
- Call the Create Video Translation API with your video URL
- Set source_language to “DEFAULT” for automatic language detection
- Specify target languages and optional voice mappings
- Configure additional options like lip-sync, captions, and background music removal
Monitor Progress:
- Use the Get Translation Result API to check processing status
- Download the translated video URL when status reaches “Completed” (status = 3)

Key Features

Automatic Language Detection

Set source_language to “DEFAULT” to automatically detect the original language of your video content.

Multiple Language Translation

Translate to multiple languages simultaneously by providing comma-separated language codes in the language parameter.

Lip-Sync Technology

Enable lipsync to synchronize mouth movements with the translated audio for more natural-looking results.

Caption Support

Add, translate, or replace subtitles with various caption handling options.

Advanced Translation Controls

Fine-tune translations with custom word mappings, pronunciation corrections, and translation styles.

Response Code Description

Please note that if the value of the response code is not equal to 1000, the request has failed or encountered an error.

Code	Description
1000	Success
1003	Parameter error or Parameter cannot be empty
1008	The content you requested does not exist
1009	You do not have permission to perform this operation
1101	Invalid authorization or The request token has expired
1102	Authorization cannot be empty
1200	The account has been banned
1201	Create audio error, please try again later
1202	The same video cannot be translated with lip-sync in the same language more than once
1203	Video should contain audio
1204	Your video duration exceeds 60 seconds
1205	Create video error, please try again later
1207	The video you are using exceeds the size limit of 300MB
1209	Please upload a video in another encoding format
1210	The video you are using exceeds the frame rate limit of 30fps

Video Translation Status Codes

When checking results, the video_status field indicates the current processing state:

Status	Description
1	Queueing - Your request is waiting to be processed
2	Processing - Video translation is currently being generated
3	Completed - Translation finished successfully, video URL is available
4	Failed - Translation failed, check error details for more information

Best Practices

Video Requirements

Duration: Keep videos under 60 seconds for optimal processing time
Size: Maximum file size is 300MB
Frame Rate: Maximum 30fps supported
Audio: Ensure your video contains clear audio for accurate translation
Encoding: Use standard encoding formats (H.264 recommended)

Translation Quality Tips

Clear Speech: Videos with clear, well-articulated speech produce better translations
Background Noise: Consider using remove_bgm: true to remove background music for clearer voice translation
Speaker Count: Specify the correct number of speakers for better voice separation

API Usage Tips

Webhook: Use the webhookUrl parameter to receive notifications when processing is complete
Batch Processing: For multiple videos, process them in parallel but monitor your quota usage
Error Handling: Implement proper retry logic for failed translations
Result Management: Download and save translated videos promptly as they expire after 7 days

Common Use Cases

Single Language Translation

{
  "url": "https://example.com/my-video.mp4",
  "source_language": "DEFAULT",
  "language": "es",
  "lipsync": true,
}

Multi-Language Translation

{
  "url": "https://example.com/my-video.mp4",
  "source_language": "DEFAULT",
  "language": "es,fr,de",
  "lipsync": false,
  "caption_type": 2,
  "remove_bgm": true
}

Professional Translation with Advanced Controls

{
  "url": "https://example.com/business-video.mp4",
  "source_language": "DEFAULT",
  "language": "zh-CN",
  "lipsync": true,
  "studio_voice": {
    "style": "professional",
    "no_translate_words": ["AKool", "API"],
    "fixed_words": {"hello": "您好"}
  },
  "caption_type": 3,
  "webhookUrl": "https://your-server.com/webhook"
}

Support

For additional help and examples, check out our:

Authentication

Face Swap

Streaming Avatar

Talking Photo