提交图片唱演任务

1. 接口描述

接口请求域名： vclm.tencentcloudapi.com 。

用于提交图片唱演任务。
支持提交音频和图片生成唱演视频，满足社交娱乐、互动营销等场景的需求。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 调用成功-图片url地址

调用成功

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitPortraitSingJob
<公共请求参数>

{
    "AudioUrl": "https://***/test.mp3",
    "ImageUrl": "https://***/test.png"
}

输出示例

{
    "Response": {
        "JobId": "1199964964965990400",
        "RequestId": "79655032-c347-4f05-af23-ae80f7ff47eb"
    }
}

示例2 调用失败-音频时长超限

音频时长超限

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitPortraitSingJob
<公共请求参数>

{
    "AudioUrl": "https://***/durationInvalid.m4a",
    "ImageUrl": "https://***/aj.jpg"
}

输出示例

{
    "Response": {
        "Error": {
            "Code": "InvalidParameterValue.InvalidAudioDuration",
            "Message": "音频时长超出限定范围。上传音频的时长要求：在1秒到60秒范围内"
        },
        "RequestId": "9d314f18-3670-4793-bf4b-619b43494ac7"
    }
}

示例3 调用失败-图片分辨率超限

图片分辨率超限

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitPortraitSingJob
<公共请求参数>

{
    "AudioUrl": "https://***/test.mp3",
    "ImageUrl": "https://***/resolutionInvalid.jpg"
}

输出示例

{
    "Response": {
        "Error": {
            "Code": "InvalidParameterValue.InvalidImageResolution",
            "Message": "图片分辨率超出限定范围。上传图片的长边分辨率要求：在0到2560范围内"
        },
        "RequestId": "29498231-20eb-43d1-bb3b-cc9e07978699"
    }
}

示例4 调用失败-图片宽高比超限

图片宽高比超限

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitPortraitSingJob
<公共请求参数>

{
    "AudioUrl": "https://***/test.mp3",
    "ImageUrl": "https://***/ratioInvalid.jpg"
}

输出示例

{
    "Response": {
        "Error": {
            "Code": "InvalidParameterValue.InvalidImageAspectRatio",
            "Message": "图片宽高比超出限定范围。上传图片的宽高比要求：在0.5到2.0范围内"
        },
        "RequestId": "3c9cb9bd-5b2a-4b18-a890-73f7712ca2ce"
    }
}

示例5 调用失败-图片大小超限

图片大小超限

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitPortraitSingJob
<公共请求参数>

{
    "AudioUrl": "https://***/test.mp3",
    "ImageUrl": "https://***/storageInvalid.jpg"
}

输出示例

{
    "Response": {
        "Error": {
            "Code": "InvalidParameterValue.InvalidImageSize",
            "Message": "图片大小超出限定范围。上传图片的大小要求：在0MB到10MB范围内"
        },
        "RequestId": "cd17e6bb-afdb-4bed-8a15-55c461333104"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。