V-API

任务：生成数字人视频

POST

/avatar/generation

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

avatar_url

string

数字人形象

必需

数字人形象的图片或视频URL地址

audio_url

string

数字人声音

可选

音频网络URL地址，例如 https://example.com/audio.mp3
(三个参数，三选一：audio_url|create_voice|use_voice)

no_watermark

boolean

是否去除水印

可选

默认值:

false

create_voice

object

创建数字人声音

可选

使用音频创建voice声音后生成数字人
(三个参数，三选一：audio_url|create_voice|use_voice)

audio_url

string

音频文件URL

必需

音色音频URL（用于ai模仿音色，录制至少20秒的声音作为音色取样）

language

enum<string>

语言

必需

枚举值:

zhen

示例值:

text

string

要转换的文本内容

必需

use_voice

object

使用已有声音

可选

使用已有的voice生成数字人。可通过【默认voice列表接口】获取所有默认的vocie，然后选择需要的声音音色
(三个参数，三选一：audio_url|create_voice|use_voice)

voice_engine_id

string

语音引擎ID

必需

audio_id

string

音频ID

必需

language

enum<string>

语言

必需

枚举值:

enzh

示例值:

text

string

要转换的文本内容

必需

示例

{
    "audio_url": "https://cdn.gptbest.vip/file/cdn/20250107/RFDQkBGVrHFydzGzzvgXGQmbuPhicK.mp3",
    "avatar_url": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_119206500/9065890952728122033/out.mp4",
    "no_watermark":true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gpt.ge/avatar/generation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "audio_url": "https://cdn.gptbest.vip/file/cdn/20250107/RFDQkBGVrHFydzGzzvgXGQmbuPhicK.mp3",
    "avatar_url": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_119206500/9065890952728122033/out.mp4",
    "no_watermark":true
}'

返回响应

🟢200成功

application/json

Body

string

任务ID

必需

返回任务ID，后续通过查询接口，查询视频完成结果

示例

{
    "code": "success",
    "message": "",
    "data": "57b9ba07db5e4ed5bf18ebb4179a826d"
}

修改于 2025-02-24 18:30:55

必读指南

查询：任务结果