数字人在线克隆任务提交 - 奇妙元--开放接口样例

请求参数

Header 参数

appKey

string

可选

示例值:

EB22DFC5E32C123D274BA960FE0E5534

timestamp

string

时间戳，单位秒

可选

signature

string

签名信息

可选

Body 参数application/json

avatarType

string

必需

数字人类型，支持两种类型，fixed_avatar：固定数字人
move_avatar：走动数字人

videoUrl

string

必需

数字人训练视频，时长需控制在3-5分钟，且包含音频信息，人脸需全程出现在视频内

callbackUrl

string

回调地址

可选

videoBgMatting

boolean

必需

是否ai去除视频背景，true代表去除视频背景，克隆2.5d数字人，false代表克隆实景数字人，默认为false

avatarName

string

数字人名称

必需

needAuthorized

boolean

可选

是否需要授权视频审核，true代表需要，false不需要，默认不需要

authorizedText

string

可选

needAuthorized=true时必传，授权文本，系统将自动检测授权视频的音频内容和该文本的匹配度

authorizedVideoUrl

string

可选

needAuthorized=true必传，用于授权审核的授权视频，用户需要按照authorizedText规定的文本录制该视频

limitRatio

number

可选

授权审核文本差异限制阈值，超过该值，授权审核不通过，不允许克隆数字人。不指定该值，系统默认阈值为0.4，当文本差异度超过0.4时，不允许通过

示例

{
  "avatarType": "fixed_avatar",
  "videoUrl": "https://tc-nj-digitalhuman-pb-cos.moyin.com/mid/wetawebsit/mp4/2025-01/046c9a172bce59cf4e28b9372299a08a.mp4",
  "callbackUrl": "http://123.456.com",
  "videoBgMatting": true,
  "avatarName": "api克隆数字人",
  "needAuthorized": true,
  "authorizedText": "我(你的姓名)本人声明，同意奇妙元使用我的视频制作奇妙元数字人，并在我的奇妙元平台上使用。",
  "authorizedVideoUrl": "https://tc-nj-digitalhuman-pb-cos.moyin.com/mid/wetawebsit/mp4/2025-01/e039c31c043256b3eb155fec91b307d7.mp4",
  "limitRatio": 0.4
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/metaman/open/avatar/online/clone' \
--header 'Content-Type: application/json' \
--data-raw '{
    "avatarType": "fixed_avatar",
    "videoUrl": "https://tc-nj-digitalhuman-pb-cos.moyin.com/mid/wetawebsit/mp4/2025-01/046c9a172bce59cf4e28b9372299a08a.mp4",
    "callbackUrl": "http://123.456.com",
    "videoBgMatting": true,
    "avatarName": "api克隆数字人",
    "needAuthorized": true,
    "authorizedText": "我(你的姓名)本人声明，同意奇妙元使用我的视频制作奇妙元数字人，并在我的奇妙元平台上使用。",
    "authorizedVideoUrl": "https://tc-nj-digitalhuman-pb-cos.moyin.com/mid/wetawebsit/mp4/2025-01/e039c31c043256b3eb155fec91b307d7.mp4",
    "limitRatio": 0.4
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

string

必需

ok

boolean

必需

示例

成功示例异常示例

{
  "code": 200,
  "message": "操作成功",
  "data": "6788b885ade2de2db3c16544",
  "ok": true
}