查询素材列表

1. 接口描述

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

通常通过腾讯云人脸融合的控制台可以查看到素材相关的参数数据，可以满足使用。本接口返回活动的素材数据，包括素材状态等。用于用户通过Api查看素材相关数据，方便使用。

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

2. 输入参数

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

3. 输出参数

4. 示例

示例1 素材列表

拉起素材列表(对外)

输入示例

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

{
    "ActivityId": "10",
    "Limit": "10",
    "MaterialId": "\"q-materialId-000\"",
    "Offset": "1"
}

输出示例

{
    "Response": {
        "MaterialInfos": [
            {
                "MaterialStatus": 2,
                "MaterialId": "qc_300232_698652_24",
                "MaterialFaceList": [
                    {
                        "FaceId": "300232_24_1",
                        "FaceInfo": {
                            "X": 43,
                            "Y": 86,
                            "Width": 127,
                            "Height": 127
                        }
                    }
                ],
                "CreateTime": "2020-04-09T03:27:02.903Z",
                "UpdateTime": "2020-04-09T03:27:02.903Z",
                "BlendParamPtu": 50,
                "BlendParamYoutu": 50,
                "PositionParamPtu": 50,
                "PositionParamYoutu": 50,
                "Url": "https://facefusion-test-1254418846.cos.ap-guangzhou.myqcloud.com/251009261/300232/qc_300232_698652_24?q-sign-algorithm=sha1&q-ak=AKIDwPsEPTKPkvyqWIN2iCUeeU9brvnUQIgx&q-sign-time=1589864388;1589864688&q-key-time=1589864388;1589864688&q-header-list=&q-url-param-list=&q-signature=0238eb819c073d889ba056a151cdfe4688c1b5fa"
            }
        ],
        "Count": 1,
        "RequestId": "testDescribeMaterialList1589864389240"
    }
}

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. 错误码

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