Generate AI Avatar Videos

Global Server

https://video.a2e.ai

POST

/api/v1/video/generate

Quality of the lip-sync: depending on whether you choose to “train a personalized avatar” (in the Add Avatar and Train Lip-sync section), the system will automatically apply either the universal lip-sync model or the dedicated trained lip-sync model for your avatar. If you skip “train a personalized avatar,” the lip-sync results for your avatar will be less realistic compared to using a dedicated lip-sync model trained with your avatar’s video.

Get the id of the avatar as "_id" returned by /api/v1/anchor/character_list.

Why is video generation sometimes slow? Please pay special attention to the parameter isSkipRs, which corresponds to Smart Motion Adjustment in the web UI. Enabling this option enhances the naturalness of the AI avatar’s movements. However, it can significantly slow down the generation process.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "title": "My first AI video",
    "anchor_id": "660556b3cd492168141926d3",
    "anchor_type": 1,
    "back_id": "62a6d3e56c209514b155b12b",
    "audioSrc": "https://speech_cdn.ai-anchor.com/dubbing_stable/pyK1dvqcDKpKJo1IcEPm_9714_fr.mp3",
    "resolution": 1080,
    "web_bg_width": 853,
    "web_bg_height": 480,
    "web_people_width": 270,
    "web_people_height": 480,
    "web_people_x": 292,
    "web_people_y": 0,
    "isSkipRs": true,
    "isCaptionEnabled": true,
    "captionAlign": {
        "language": "en-US",
        "PrimaryColour": "rgba(247, 89, 171, 1)",
        "OutlineColour": "rgba(0, 0, 0, 1)",
        "BorderStyle": 4,
        "BackColour": "rgba(146, 84, 222, 1)",
        "FontName": "AaFengKuangYuanShiRen",
        "Fontsize": 50,
        "subtitle_position": 0.3
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://video.a2e.ai/api/v1/video/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "My first AI video",
    "anchor_id": "660556b3cd492168141926d3",
    "anchor_type": 1,
    "back_id": "62a6d3e56c209514b155b12b",
    "audioSrc": "https://speech_cdn.ai-anchor.com/dubbing_stable/pyK1dvqcDKpKJo1IcEPm_9714_fr.mp3",
    "resolution": 1080,
    "web_bg_width": 853,
    "web_bg_height": 480,
    "web_people_width": 270,
    "web_people_height": 480,
    "web_people_x": 292,
    "web_people_y": 0,
    "isSkipRs": true,
    "isCaptionEnabled": true,
    "captionAlign": {
        "language": "en-US",
        "PrimaryColour": "rgba(247, 89, 171, 1)",
        "OutlineColour": "rgba(0, 0, 0, 1)",
        "BorderStyle": 4,
        "BackColour": "rgba(146, 84, 222, 1)",
        "FontName": "AaFengKuangYuanShiRen",
        "Fontsize": 50,
        "subtitle_position": 0.3
    }
}'

Responses

🟢200generate

application/json

Body

Example

{
    "code": 0,
    "data": {
        "title": "202404071749",
        "msg": "",
        "algo_result": "",
        "result": "",
        "retry": 0,
        "process": 0,
        "isDel": false,
        "isSkipRs": false,
        "status": "start",
        "error": "",
        "anchor_type": "1",
        "resolution": "1080",
        "voice_type": "0",
        "audioSrc": "https://dh24as48lv9ce.cloudfront.net/ai/speech/tts/azure_service/azure_synth.-8161556380964742732.wav",
        "custom_voice": "",
        "priority": 4,
        "restart_date": null,
        "audioLen": 5,
        "web_people_width": 608,
        "web_people_height": 1080,
        "web_people_x": 657,
        "web_people_y": 0,
        "web_bg_width": 1920,
        "web_bg_height": 1080,
        "color": "",
        "result_cover": "",
        "wl_model": "WLGPNormal",
        "anchor_background_img": "",
        "anchor_background_color": "",
        "_id": "6613b4c216004c1df435d6ff",
        "user_id": "637498294abbb165572d5dbe",
        "anchor_id": "660556b3cd492168141926d3",
        "web_dist_bg_width": -2,
        "web_dist_bg_height": -2,
        "web_dist_bg_x": 0,
        "web_dist_bg_y": 0,
        "replace_bg_id": "62a6d3e56c209514b155b12b",
        "version": 1,
        "createdAt": "2024-04-08T09:11:30.329Z",
        "updatedAt": "2024-04-08T09:11:30.329Z",
        "__v": 0
    }
}

Modified at 2025-07-10 07:41:10

Delete a User Voice

List of Result Videos