Generate a digital human avatar

POST

/chanjing/open/v1/create_customised_person

Asynchronous task, specific progress can be checked through the query interface
QPS: 10/1min
Reference: https://alidocs.dingtalk.com/i/nodes/QOG9lyrgJP3Qp73mHrK9dpAPVzN67Mw4

Parameter Description

Field	Description
name	Name of the customized digital human
material_video	Downloadable video file link accessible from the external network (customers need to upload the local video file to an OSS platform first) Template or vertical video, supports MP4/MOV/WebM formats, 360p-4k resolution Duration: 30 seconds to 5 minutes, file size not exceeding 2GB
callback	Callback URL. A POST request will be sent to this address after the task is completed. The request body format is the same as the data returned by the digital human details query (#)
train_type	Training type [Optional]. Parameter options: - figure [Only generates the avatar, allows passing video without audio]
language	Language [Optional]. Can be specified when generating voice, defaults to cn (Chinese), supports en (English). Other languages are not supported currently. For special language requirements, please contact customer service

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

name

string

required

material_video

string

required

callback

string

required

train_type

string

required

Example

{
    "name": "302test",
    "material_video": "https://res.chanjing.cc/chanjing/res/person/2024-07-02/489157a8-f164-422c-9748-d8758131aa09_480.webm",
    "callback": "",
    "train_type": ""
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/chanjing/open/v1/create_customised_person' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "302test",
    "material_video": "https://res.chanjing.cc/chanjing/res/person/2024-07-02/489157a8-f164-422c-9748-d8758131aa09_480.webm",
    "callback": "",
    "train_type": ""
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

string

required

msg

string

required

trace_id

string

required

Example

{
    "code": 0,
    "data": "C-ef6db16b08bc46a6a3558cd8d8806b70",
    "msg": "success",
    "trace_id": "852ae8a5d71aa84b4ecbcf96b4740aca"
}

Modified at 2025-06-23 07:20:23

Retrieve the list of supported fonts

Retrieve avatar details

Generate a digital human avatar

Parameter Description#

Request

Request samples

Responses

Parameter Description