AI Tools Suite
lipSync
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.
Create lipSync
POST https://openapi.akool.com/api/open/v3/content/video/lipsync
Request Headers
Parameter | Value | Description |
---|---|---|
Authorization | Bearer token | Your API Key used for request authorization. You can get from https://openapi.akool.com/api/open/v3/getToken api. |
Body Attributes
Parameter | Type | Value | Description |
---|---|---|---|
video_url | String | The video url address you want to lipsync, fps greater than 25 will affect the generated effect. It is recommended that the video fps be below 25. | |
audio_url | String | resource address of the audio,It is recommended that the audio length and video length be consistent, otherwise it will affect the generation effect. | |
webhookUrl | String | Callback url address based on HTTP request. |
Response Attributes
Parameter | Type | Value | Description |
---|---|---|---|
code | int | 1000 | Interface returns business status code(1000:success) |
msg | String | Interface returns status information | |
data | Object | { "_id": "", "video_status": 1, "video": "" } | id : Interface returns data, video_status: the status of video: [1:queueing, 2:processing, 3:completed, 4:failed], video: the url of Generated video |
Example
Body
{
"video_url": "https://d11fbe263bhqij.cloudfront.net/agicontent/video/global_reach/Global_reach_EN_01.mp4",
"audio_url": "https://drz0f01yeq1cx.cloudfront.net/1712719410293-driving_audio_2.wav",
"webhookUrl": "https://openapitest.akool.com/api/open/v3/test/webhook"
}
Request
Response
{
"code": 1000,
"msg": "OK",
"data": {
"create_time": 1712720702523,
"uid": 100002,
"type": 9,
"from": 2,
"target_video": "https://d11fbe263bhqij.cloudfront.net/agicontent/video/global_reach/Global_reach_EN_01.mp4",
"faceswap_quality": 2,
"video_id": "8ddc4a27-d173-4cf5-aa37-13e340fed8f3",
"video_status": 1, // current status of video: 【1:queueing(The requested operation is being processed),2:processing(The requested operation is being processing),3:completed(The request operation has been processed successfully),4:failed(The request operation processing failed, the reason for the failure can be viewed in the video translation details.)】
"video_lock_duration": 11.7,
"deduction_lock_duration": 20,
"external_video": "",
"video": "", // the url of Generated video
"storage_loc": 1,
"input_audio": "https://drz0f01yeq1cx.cloudfront.net/1712719410293-driving_audio_2.wav",
"webhookUrl": "https://openapitest.akool.com/api/open/v3/test/webhook",
"task_id": "66160b3ee3ef778679dfd30f",
"lipsync": true,
"_id": "66160f989dfc997ac289037b",
"__v": 0
}
}
Get Video Info Result
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=66160f989dfc997ac289037b
Request Headers
Parameter | Value | Description |
---|---|---|
Authorization | Bearer token | Your API Key used for request authorization. You can get from https://openapi.akool.com/api/open/v3/getToken api. |
Query Attributes
Parameter | Type | Value | Description |
---|---|---|---|
video_model_id | String | NULL | video db id: You can get it based on the _id field returned by https://openapi.akool.com/api/open/v3/content/video/lipsync . |
Response Attributes
Parameter | Type | Value | Description |
---|---|---|---|
code | int | 1000 | Interface returns business status code(1000:success) |
msg | String | OK | Interface returns status information |
data | Object | { video_status:1, _id:"", video:"" } | video_status: the status of video:【1:queueing, 2:processing, 3:completed, 4:failed】 video: Generated video resource url _id: Interface returns data |
Example
Request
Response
{
"code": 1000,
"msg": "OK",
"data": {
"faceswap_quality": 2,
"storage_loc": 1,
"_id": "66160f989dfc997ac289037b",
"create_time": 1692242625334,
"uid": 378337,
"type": 2,
"from": 1,
"video_id": "788bcd2b-09bb-4e9c-b0f2-6d41ee5b2a67",
"video_lock_duration": 7.91,
"deduction_lock_duration": 10,
"video_status": 2, // current status of video: 【1:queueing(The requested operation is being processed),2:processing(The requested operation is being processing),3:completed(The request operation has been processed successfully),4:failed(The request operation processing failed, the reason for the failure can be viewed in the video translation details.)】
"external_video": "",
"video": "" // Generated video resource url
}
}
Response Code Description
Please note that if the value of the response code is not equal to 1000, the request is failed or wrong
Parameter | Value | Description |
---|---|---|
code | 1000 | Success |
code | 1003 | Parameter error or Parameter can not beempty |
code | 1008 | The content you get does not exist |
code | 1009 | Youdo not have permission to operate |
code | 1101 | Invalid authorization or Therequest token has expired |
code | 1102 | Authorization cannot be empty |
code | 1200 | The account has been banned |
code | 1201 | create audio error, pleasetry again later |
code | 1202 | The same video cannot be translated lipSync inthe same language more than 1 times |
code | 1203 | video should be with audio |
code | 1204 | Your video duration is exceed 60s! |
code | 1205 | Create videoerror, please try again later |
code | 1207 | The video you are using exceeds thesize limit allowed by the system by 300M |
code | 1209 | Please upload a videoin another encoding format |
code | 1210 | The video you are using exceeds thevalue allowed by the system by 60fp |
code | 1211 | Create lipsync error, pleasetry again later |