数字人视频相关接口文档

统一接口入口

POST /api

通过统一入口调用所有API。

请求格式

{
    "apiname": "API名称",
    "params": {
        "参数名": "参数值"
    }
}

支持的API列表

统一响应格式

成功响应：

{
    "code": 0,
    "message": "success",
    "data": { ... }
}

失败响应：

{
    "code": -1,
    "message": "错误描述",
    "data": {}
}

接口详细说明

1. 专业数字人克隆

apiname: 专业数字人克隆

基于视频训练高精度数字人模型。

请求参数

Body参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "专业数字人克隆",
    "params": {
        "videoUrl": "https://golden-final.com/train.mp4",
        "authVideoUrl": "https://neat-armoire.net/auth.mp4",
        "authText": "鱼仙儿"
            }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

视频文件要求

训练视频：

• 文件大小：小于等于1GB
• 时长：30\~120秒
• 帧率：10～60fps（推荐：25）
• 视频编码：h264、HEVC(h265)
• 格式：mp4、mov
• 分辨率：最大支持2k（单边不大于2000，2000×2000）

授权视频：

• 文件大小：小于100MB
• 时长：小于2分钟
• 视频编码：h264、HEVC(h265)
• 格式：mp4、mov

2. 极速数字人克隆

apiname: 极速数字人克隆

快速训练数字人模型，训练速度更快。

请求参数

Body参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "极速数字人克隆",
    "params": {
        "videoUrl": "https://golden-final.com/train.mp4",
        "authVideoUrl": "https://neat-armoire.net/auth.mp4",
        "authText": "鱼仙儿",
        "callbackUrl": "https://exotic-reservation.org/hook"
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

视频文件要求

训练视频：

• 文件大小：小于等于500MB
• 时长：5～60秒
• 帧率：10～60fps（推荐：25）
• 视频编码：h264、HEVC(h265)
• 格式：mp4、mov
• 分辨率：最大支持2k（单边不大于2000，2000×2000）

授权视频：

• 文件大小：小于100MB
• 时长：小于2分钟
• 视频编码：h264、HEVC(h265)
• 格式：mp4、mov

3. 声音克隆

apiname: 声音克隆

支持上传音频及进行音色复刻。

请求参数

Body参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "声音克隆",
    "params": {
        "audioUrl": "https://fragrant-makeover.info/reproduce.mp3",
        "model": "s3",
        "language": "zh-CN",
        "demoText": "你好，我是你的专属AI克隆声音",
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

音频文件要求

• 格式：mp3、wav（推荐）、m4a
• 时长：
• V1、V2、V3模型：5秒～120秒
• S1、S3模型：10秒～120秒
• 文件大小：小于等于10MB

4. 图生数字人克隆

apiname: 图生数字人克隆

基于图片生成数字人模型。

请求参数

请求示例

{
    "apiname": "图生数字人克隆",
    "params": {
        "imageUrl": "https://example.com/face.jpg",
        "authText": "鱼仙儿",
        "authVideoUrl": "https://neat-armoire.net/auth.mp4"
    }
}

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

5. 数字人口播视频(无包装)

apiname: 数字人口播视频

生成数字人口播视频（无包装）。

生成方式说明

方式一：基于"文本内容 + 定制声音"生成视频

• 文本内容：字符数要求（3 \~ 3,600字符）
• 声音ID：声音定制产生的声音ID

方式二：基于"音频文件"生成视频

• 时长：0.5秒 \~ 10分钟
• 格式：mp3、wav、m4a
• 文件大小：小于等于100MB

请求参数

Body参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "数字人口播视频",
    "params": {
        "virtualmanId": "68aebb91b8619ed6f4168f40",
        "text": "你好，我是你的专属AI克隆声音",
        "speakerId": "68aebb91b8619ed6f4168f40",
        "speedRatio": 1,
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

6. 数字人口播混剪视频

apiname: 数字人口播混剪视频

生成数字人混剪视频。

请求参数

Body参数

materials参数说明

introduceCard参数说明

packRules参数说明

processRules参数说明

subtitle参数说明

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "数字人口播混剪视频",
    "params": {
        "styleId": "68aebb91b8619ed6f4168f40",
        "virtualmanId": "68aebb91b8619ed6f4168f40",
        "audioUrl": "https://golden-final.com/a.mp3",
        "speakerId": "68aebb91b8619ed6f4168f40",
        "speakerExtra": {
            "speedRatio": 1,
            "language": "zh-CN",

        },
        "content": "AI行业是一个充满机遇的行业",
        "title": "聊AI行业",
        "materials": [
            {
                "type": "image",
                "fileUrl": "https://golden-final.com/a.jpg"
            },
            {
                "type": "video",
                "fileUrl": "https://golden-final.com/b.mp4"
            }
        ],
        "materialSoundSwitch": false,
        "introduceCard": {
            "name": "会长",
            "description": "医美领军人物"
        },
        "packRules": {
            "headerSwitch": true,
            "materialSwitch": true,
            "subtitleSwitch": true,
            "keywordSwitch": true,
            "backgroundMusic": {
                "audioSwitch": true,
                "audioUrl": "https://golden-final.com/bg.mp3",
                "volume": 1
            }
        },
        "processRules": {
            "watermarkShow": true,
            "materialMatchWay": "fuzzyMatch",
           "firstFrameCover":{
                "coverSwitch":true,
                "templateId":"69b3ce905a79730032b9ed6e",
                "imageUrl":"https://v.xyaip.fun/1776479830396_fnhvfgp3_1766718234389_ejqad1h2_啸岳_副本.jpg"

           }
        },
    }
  }'
````

#### 返回值

```json
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

7. 素材混剪视频

apiname: 素材混剪视频

素材混剪生成视频。

请求参数

Body参数

speakerExtra参数说明

materials参数说明

introduceCard参数说明

packRules参数说明

processRules参数说明

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "素材混剪视频",
    "params": {
        "styleId": "68aebb91b8619ed6f4168f40",
        "audioUrl": "https://golden-final.com/a.mp3",
        "speakerId": "68aebb91b8619ed6f4168f40",
        "speakerExtra": {
            "speedRatio": 1,
            "language": "zh-CN",

        },
        "content": "AI行业是一个充满机遇的行业",
        "title": "聊AI行业",
        "materials": [
            {
                "type": "image",
                "fileUrl": "https://golden-final.com/a.jpg",
                "soundSwitch": false
            },
            {
                "type": "video",
                "fileUrl": "https://golden-final.com/b.mp4",
                "soundSwitch": false
            }
        ],
        "introduceCard": {
            "name": "会长",
            "description": "医美领军人物"
        },
        "packRules": {
            "headerSwitch": true,
            "materialSwitch": true,
            "subtitleSwitch": true,
            "keywordSwitch": true,
            "backgroundMusic": {
                "audioSwitch": true,
                "audioUrl": "https://golden-final.com/bg.mp3",
                "volume": 1
            }
        },
        "processRules": {
            "watermarkShow": true,
             "firstFrameCover":{
                "coverSwitch":true,
                "templateId":"69b3ce905a79730032b9ed6e",
                "imageUrl":"https://v.xyaip.fun/1776479830396_fnhvfgp3_1766718234389_ejqad1h2_啸岳_副本.jpg"

           }
        },
        "callbackUrl": "https://exotic-reservation.org/hook"
    }
  }'
````

#### 返回值

```json
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

8. 剪辑模板列表

apiname: 剪辑模板列表

获取剪辑模板列表（GET请求）。

请求参数

Query参数

scene枚举值说明

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "剪辑模板列表",
    "params": {
        "pageSize": 10,
        "scene": "virtualman",
        "sortBy": "desc"
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "results": [
            {
                "id": "string",
                "name": "string",
                "coverUrl": "string",
                "scene": "virtualman",
                "demoUrl": "string"
            }
        ],
        "sid": "string"
    }
}

返回字段说明

9. 封面模板列表

apiname: 封面模板列表

获取封面模板列表（GET请求）。

请求参数

Query参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "封面模板列表",
    "params": {
        "pageSize": 10,
        "sortBy": "desc"
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "results": [
            {
                "id": "string",
                "name": "string",
                "coverUrl": "string"
            }
        ],
        "sid": "string"
    }
}

返回字段说明

10. 文本转语音

apiname: 文本转语音

文本转换为语音。

请求参数

Body参数

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{
    "apiname": "文本转语音",
    "params": {
        "text": "你好，我是你的专属AI克隆声音，希望未来的日子一起好好相处哦！",
        "speakerId": "68e8d31a49c3b000398828dc",
        "language": "zh-CN",
        "speedRatio": 1,
        "volume": 1,
        "codec": "mp3",
        "returnSubtitle": true
    }
  }'

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "requestId": "string"
    }
}

返回字段说明

11. 查询任务详情

apiname: 查询任务详情

查询任务状态和结果（GET请求）。

请求参数

请求示例

{
    "apiname": "查询任务详情",
    "params": {
        "taskId": "task_123456"
    }
}

返回值

{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "string",
        "status": "pending|processing|success|failed",
        "progress": 0,
        "result": {
            "videoUrl": "string",
            "coverUrl": "string",
            "aiCoverSucceed": true,
            "audioUrl": "string",
            "imageUrl": "string",
            "text": "string",
            "subtitle": [
                {
                    "text": "string",
                    "startMs": "string",
                    "endMs": "string"
                }
            ],
            "virtualmanId": "string",
            "speakerId": "string",
            "demoAudioUrl": "string",
            "duration": 0
        },
        "errorMsg": "string",
        "createTime": "string",
        "updateTime": "string"
    }
}

错误码说明

接口权限验证

所有 /api 接口调用前需要进行权限验证，验证方式为在请求头中携带 X-App-Id 和 X-App-Secret。

验证参数

当前配置

appid: 
app_secret: 

请求示例

curl -X POST https://yxyx.xyaip.fun/api \
  -H "X-App-Id: " \
  -H "X-App-Secret: " \
  -H "Content-Type: application/json" \
  -d '{"apiname": "专业数字人克隆", "params": {...}}'

权限验证错误码

注意事项

1. 所有接口均通过统一入口 /api 调用
2. 请求体格式必须为 JSON，包含 apiname 和 params 字段
3. GET类型接口（模板列表、任务详情）参数会自动转为URL查询参数
4. 调用接口必须在请求头中携带 X-App-Id 和 X-App-Secret
5. 如果请求头未携带 Authorization，系统自动使用配置文件中的api_key
6. 训练视频分辨率最大支持2k（单边不大于2000）