闪剪 Agent API
  1. 数字人
闪剪 Agent API
  • 使用说明
    • 产品介绍
    • 常见对接问题
  • API 接口
    • 登录 / 鉴权
      • 身份验证
      • 刷新token
      • 获取文件上传临时授权
    • 结果通知
      • 视频制作结果通知
      • 数字人训练结果通知
      • 声音训练结果通知
    • 数字人
      • 数字人训练
        POST
      • 数字人训练结果查询
        GET
      • 数字人列表
        GET
      • 获取极速数字人封面
        GET
      • 待人工审核列表
        GET
      • 审核数字人
        PUT
      • 审核详情
        GET
    • 声音
      • 声音训练
      • 声音训练结果查询
      • 声音保存/放弃
      • 声音提取字幕
      • 声音列表
      • 声音试听
      • 声音试听结果轮询
      • 查询声音提取字幕结果
      • 方言音色列表
      • 语种列表
      • 公共音色列表
      • 方言(口音)列表
    • 作品
      • 作品列表
      • 作品结果详情
    • 视频制作相关
      • 纯数字人口播视频
      • 数字人口播混剪
      • 真人口播视频智剪
      • 新闻体视频
      • 素材混剪视频
      • 风格模板列表
      • 调整素材-获取视频工程文件
      • 调整素材-提交制作
    • 自定义素材相关
      • 第三方素材转存
      • 素材审计
      • 获取自定义素材列表
    • 旧版智能剪辑
      • 官方模板列表
      • 官方模版素材列表
      • 【旧版】数字人口播混剪
    • 其它
      • 兑换码查询
      • 算力消耗查询
  1. 数字人

数字人训练

POST
/v1/virtualman/create
注:训练视频,专业版数字人请传30秒以上的视频,以保证训练效果。
训练视频需要保证人脸始终在画面中(镜头不可以太远),人脸没有大幅偏转、侧脸的情况。人物需要说话,亦不建议直接复读数字(容易导致口型匹配不完美)。
训练视频时长限制:
专业版:最小30秒,最大90秒(这里的90秒,指的是裁剪参数中,duration的裁剪区间,并非训练视频文件本身时长)
极速版:最小10秒,最大300秒
数字人训练视频和授权视频必需上传到闪剪服务区
上传方式参考腾讯云COS上传SDK进行上传:https://cloud.tencent.com/document/product/436,上传凭据详见【获取文件临时授权】接口
授权视频的授权内容为:
我是 xxx ( 真实姓名 ),我授权 代理商应用名称使用视频中的肖像、声音,为我生成定制数字人及声音,并在本人{代理商应用名称} 账号中创作使用。

请求参数

Header 参数

Body 参数application/json

示例
{
    "type": "pro",
    "videoUrl": "https://frivolous-almighty.info/",
    "authVideoUrl": "https://instructive-fundraising.com/",
    "virtualmanName": "赛梓萱",
    "voiceId": "67",
    "callbackUrl": "https://foolhardy-mainstream.biz/",
    "crop": {
        "scale": [
            1920,
            -1
        ],
        "crop": [
            608,
            1080,
            656,
            0
        ],
        "duration": [
            0,
            30
        ]
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://aiagent-openapi.sjzn.com/v1/virtualman/create' \
--header 'sja-application-code: SzpXTAfS5er2LbAf' \
--header 'sja-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImlkIjoiNjY3ZWNmNGI5Yzk2YzYzYTM0MTcyY2FhIiwibmFtZSI6IueUqOaIty0xMDAwODkiLCJsb2dpbkNvdW50IjoxN30sImlhdCI6MTczNDY3MzgyOSwiZXhwIjoxNzM0NzYwMjI5fQ.pOeYg-GcAPYdbmkS1kz9YuTCKGPC4Y-VYdajBpkbN98' \
--header 'sja-version: 1.4.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "pro",
    "videoUrl": "https://frivolous-almighty.info/",
    "authVideoUrl": "https://instructive-fundraising.com/",
    "virtualmanName": "赛梓萱",
    "voiceId": "67",
    "callbackUrl": "https://foolhardy-mainstream.biz/",
    "crop": {
        "scale": [
            1920,
            -1
        ],
        "crop": [
            608,
            1080,
            656,
            0
        ],
        "duration": [
            0,
            30
        ]
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "string",
    "data": {
        "virtualmanId": "string"
    }
}
修改于 2025-08-28 02:50:44
上一页
声音训练结果通知
下一页
数字人训练结果查询
Built with