查询素材列表

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": "at_1582658911993147392",
    "Offset": 0,
    "Limit": 5
}

输出示例

{
    "Response": {
        "Count": 5,
        "MaterialInfos": [
            {
                "AuditResult": "审核成功",
                "CreateTime": "2022-11-29 18:46:34",
                "MaterialFaceList": [
                    {
                        "FaceId": "mt_1597542526641664000_1",
                        "FaceInfo": {
                            "Height": 167,
                            "Width": 128,
                            "X": 221,
                            "Y": 125
                        }
                    }
                ],
                "MaterialId": "mt_1597542526641664000",
                "MaterialName": "test1.png",
                "MaterialStatus": 0,
                "UpdateTime": "2022-11-29 18:46:34"
            },
            {
                "AuditResult": "审核成功",
                "CreateTime": "2022-12-15 14:19:51",
                "MaterialFaceList": [
                    {
                        "FaceId": "mt_1603273612711829504_1",
                        "FaceInfo": {
                            "Height": 167,
                            "Width": 128,
                            "X": 221,
                            "Y": 125
                        }
                    }
                ],
                "MaterialId": "mt_1603273612711829504",
                "MaterialName": "test2.png",
                "MaterialStatus": 0,
                "UpdateTime": "2022-12-15 14:19:51"
            },
            {
                "AuditResult": "审核成功",
                "CreateTime": "2022-11-10 10:28:10",
                "MaterialFaceList": [
                    {
                        "FaceId": "mt_1590531733435097088_1",
                        "FaceInfo": {
                            "Height": 167,
                            "Width": 128,
                            "X": 221,
                            "Y": 125
                        }
                    }
                ],
                "MaterialId": "mt_1590531733435097088",
                "MaterialName": "test3.png",
                "MaterialStatus": 1,
                "UpdateTime": "2022-12-07 17:10:54"
            },
            {
                "AuditResult": "审核成功",
                "CreateTime": "2022-12-07 16:13:41",
                "MaterialFaceList": [
                    {
                        "FaceId": "mt_1600403157392855040_1",
                        "FaceInfo": {
                            "Height": 236,
                            "Width": 177,
                            "X": 186,
                            "Y": 95
                        }
                    }
                ],
                "MaterialId": "mt_1600403157392855040",
                "MaterialName": "test4.png",
                "MaterialStatus": 3,
                "UpdateTime": "2022-12-07 16:13:52"
            },
            {
                "AuditResult": "审核成功",
                "CreateTime": "2022-12-15 14:20:21",
                "MaterialFaceList": [
                    {
                        "FaceId": "mt_1603273738050215936_1",
                        "FaceInfo": {
                            "Height": 129,
                            "Width": 119,
                            "X": 215,
                            "Y": 69
                        }
                    }
                ],
                "MaterialId": "mt_1603273738050215936",
                "MaterialName": "test5.jpg",
                "MaterialStatus": 3,
                "UpdateTime": "2022-12-15 14:25:28"
            }
        ],
        "RequestId": "3e93f5d5-415b-41bf-bde4-c4f97e9e0089"
    }
}

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

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