API4GPT Docs

生成数字人视频

POST

https://one.api4gpt.com/avatar/generation

上传图片/视频和音频/文本，生成对应的数字人视频

请求参数

Query 参数

string

可选

Header 参数

Authorization

string

可选

示例值:

Bearer Token

string

可选

Body 参数application/json

生成数字人视频的请求参数

audio_url

string <uri>

可选

直接使用音频文件的URL

create_voice

object

可选

使用音频创建voice后生成数字人

audio_url

string <uri>

音频文件URL

可选

language

string

可选

语言代码，如 'en'、'zh' 等

示例值:

enzh

text

string

要转换的文本内容

可选

avatar_url

string <uri>

必需

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

示例

模式1：音频合成到数字人
{
    "audio_url": "https://cdn.file.boats/20250109/12N9KLFP1LTyFr8xMrrmuLYd0gbRk5.mp3",
    "avatar_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4"
}

模式2：克隆音色+生成语音+合成数字人，请注意语种设置
{
    "create_voice": {
        "audio_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4",
        "language": "cn",
        "text": "输入想要说的话"
    },
    "avatar_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4"
}

🐂🍺音频文件支持视频文件格式，会自动抽取音轨

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://one.api4gpt.com/avatar/generation' \
--header 'Authorization: Bearer Token' \
--header 'Content-Type: application/json' \
--data-raw '模式1：音频合成到数字人
{
    "audio_url": "https://cdn.file.boats/20250109/12N9KLFP1LTyFr8xMrrmuLYd0gbRk5.mp3",
    "avatar_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4"
}

模式2：克隆音色+生成语音+合成数字人，请注意语种设置
{
    "create_voice": {
        "audio_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4",
        "language": "cn",
        "text": "输入想要说的话"
    },
    "avatar_url": "https://cdn.file.boats/20250113/rKqzPLFZsIARABWwKxjOEXoBtSVPjn.mp4"
}

🐂🍺音频文件支持视频文件格式，会自动抽取音轨'

返回响应

🟢200成功响应

application/json

Body

code

number

可选

状态码，200 表示成功

data

object

可选

string

生成的任务ID

可选

示例

{
  "code": 0,
  "data": {
    "id": "string"
  }
}

修改于 2025-03-19 03:45:48

/result （获取结果）

获取任务详情