创建人物样本

最近更新时间:2019-05-30 20:49:35

1. 接口描述

接口请求域名: vod.tencentcloudapi.com 。

该接口用于创建人物样本,用于通过人脸识别等技术,进行内容识别、内容审核等视频处理。

默认接口请求频率限制:100次/秒。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreatePersonSample
Version String 公共参数,本接口取值:2018-07-17
Region String 公共参数,本接口不需要传递此参数。
Name String 人物名称,长度限制:20 个字符。
FaceContents.N Array of String 人脸图片 Base64 编码后的字符串,仅支持 jpeg、png 图片格式。数组长度限制:5 张图片。
注意:图片必须是单人像正面人脸较清晰的照片,像素不低于 200*200。
Usages.N Array of String 人物应用场景,可选值:
1. Recognition:用于内容识别,等价于 Recognition.Face。
2. Review:用于内容审核,等价于 Review.Face。
3. All:用于内容识别、内容审核,等价于 1+2。
Description String 人物描述,长度限制:1024 个字符。
Tags.N Array of String 人物标签
  • 数组长度限制:20 个标签;
  • 单个标签长度限制:128 个字符。
  • SubAppId Integer 点播子应用 ID。如果要访问子应用中的资源,则将该字段填写为子应用 ID;否则无需填写该字段。

    3. 输出参数

    参数名称 类型 描述
    Person AiSamplePerson 人物信息。
    FailFaceInfoSet Array of AiSampleFailFaceInfo 处理失败的人脸信息。
    注意:此字段可能返回 null,表示取不到有效值。
    RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 创建人物样本

    输入示例

    https://vod.tencentcloudapi.com/?Action=CreatePersonSample
    &Name=张三
    &Tags.0=美国
    &Tags.1=明星
    &Description=华语影视男演员、导演、制片人
    &Usages.0=Recognition.Face
    &Usages.1=Review.Face
    &FaceContents.0=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
    &FaceContents.1=/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCACgARgDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwDy45yeT1pDk9z+dSleT9aTbVCIsHPU0oB9TUm2lC8UAM59TScjPJqXFNxQAwEgdT+dBznqfzp+2jbQBGdx7mkOc9TUpWk20AMGfU0oz6mnbcCjFABz60HOOppcelBoQCAkDrQSfU0UUAG4+po3H1P50nekoACSe5oDH1NFFADixPc00k+ppM0hNAx24+po3E9zTM0UgHbj6mmkn1NGaQ0xCMx9TTMkdzTjTTTuAm4+p/OkLHHU/nQ3tTakBcn1NNZj6mlpp6UhjST6mmEn1NONNNAgViGHJ60Ui/eH1ooA2yPmNJipGHzGkAqgGgc0oHFOxS4oAZikxUmKQCgCPFGKeRS4oAjxSYqTFJigBmKXFOxRigBuKQin7axfEesJpsOyEg3LdARkKPU0AaU08MIzNLGn+8wFURrWnGTYLpGJ/ugkfyrz+e6mnctNKzEnJ5pYmbdthlGD2Y4FK4z0q3uIpxmGRXA9DUpFcVbSTQWrTLlX/wBg9SfrVaLV7j7SqzTsq9Cw5I9+tFwO+xTSKxtE1YXEggknWR84UkbSwx6etbpFAERFJipSKbigCPFIakIppFADaKXFIRQA00hpT1pDQA000049aaetAhKaaU00mkMa1NpxppOaBCD7w+tFA+8PrRQB0JHzGkxUrDk03FUA0ClxTsU7FAEeKTFSAUhWgBmKTFSYoxQBHijFSY4oAoAjxQRTwKa7KiM7kKijJJ7DuaAMTxFrcelRbFXfcuuVXPCj1P8AhXnVxcSXEzSzuXkY5LGretXzahqU07NkM2E9lHQVQwcZpMZJGiM3zvgewq5awFpRGUYE9Mqevv7VTjjbbvGcD0rYe8Z7WNXHmMoGGUDp6H0NICC8ubhGEM6kBRt2kDOPYkcVnEDeQAQPettLS9vkVEi3An5dy846cUl3od3ZriWCUSn7oANRzrYtU5PWxiqWjbcnBFdl4T1mS6b7LcvucDKE9T7e9ce6OkmHyrDse1X9Gc2uoxTH5dpzgdxVpkHo5FIRT1wyhlOQRkUEVQiPFIRUhFIRSAixTSKlxTSKBkZFNYVKRTSKAISKQipCKaRQBERTWFSkU0igCI02pCKaRSAYByPrRTgORRQI6Rh8xoAqQjk0mOKoBmKUinYp2OKAI9vFJipMUmKAGEUY5p+2jFADMUmBUm2jFAEeKyvFczW+gXjIASy7OT0B4JrZxWR4stjcaBdooywUMB9DmgDyip4FZ3wgYsew70xYyXAIrtPBFvbtL8yru9TWNSfIrmtKn7SVjH0/Rb6ZTsicBunFd34P+GWoapcbnj2Rbc7unP0rutFggQrhF/KvRfD88ce3OABXA8XKTsj0lgoxVzH8O/D+00aFTIm89Sp5UH2B6Vqx6Tp9uX8i0hjJ64UV1t88MlkHQfP0rnZsgnNc1W99ToopWPmr4xeHxp3iq4e3QCG4RbhAO3Zh+B/nXBxSFN28fMRX0F8YNOS7tbK5A+eMlSR2U14bf2hgZj/dNelhqnNBI8vFUuWo2tju7LmygPXKL/KpiKZYA/YbfPXy1/lU5FdhyERFNIqUimkUAR4ppFSkU0igZERTSKlIppFICIimkVKRTGFAERFNIqUimEUARkUzFSmmkUARgciinY5H1opCOnI5NG2pCOTSYqgGAUuKeF5pcUAMxxTcVKRxTcc+1ADMUYqTHFGKAIwMUYp+KMUAMxTZIxJGyMPlYFT+NS4oIoA8Zv4zb3jxEYMbFT+BrovDEJeUGInPY1S8aWjW2v3LHG2XEqn2Ix/MVL4T1O2s7ofaAdh71hWi3F2N6ElGauesaXcSx7AdqtwOTXa6ReusgVnUL1+QZNcTper6RqKxJFeRhwcYcYrSfUmtIlct9xyoI9q8lwaep7kZKS3PXLK48+ILlySv8WKramGV8FdpIzg15VbfFRNNjYWlv59yOFZuxrLXWvEfiC5+2yyyxuWyAW24FaulzR10MPaKMrLU9G1vTItUsmhfr1B9DXh/iLw7dHxBFpNsu6e6kWNM8ZycZr2bw7Pcm32XsoklB+97fWsLxda3MPiTRNR062Nxdxz7I4lOC7YO0ZpUJOnKwq8FVjczte8Pw6FYWsLG4lvCP3jRpmGPH8Jb16fjXOkV2+tazf6jaX2majpDabcWsXmGMnOBuBbJ7/WuMI5rvws5Ti3LucONpRpySiraEWKQipSOaYRXUcRERTSKlIppFAERFNIqUimkUDIiKawqUimEUgIyKYRUpFMNAERFNIqQimkUARgcj60U4D5h9aKQjqiOTQBwaew5NJiqAQCginY5pQOKAGEcUmKkIpMUAMxRinkUUAMxRin4ox6UAMxzRin49aMUAcF8SY8S2MuOqupP0I/xrj7GB7iXy4ImkJ9M8flXrHiTTU1LSZ4mTdIql4j3DY/yK868PaVqFxMs1jIqEHrnkfhWdR8quzSnHmdhy6Fq8OjNq32eZLYSeVnBDZxnOOu339a9V+E1s/iXRrlbpywjPOeuQKyJJrmy0Odry4kbbGQVyVBz7V1H7Nio8N1GMfO7ZHoMVx1Je1gelSh7Kdr9DE8QeEzpN4wuQsVtI4OVbLMp/lUHhnwdbMLoy3kk0jkC28ksrp82cn1OOMV7rqOmWGqWzRXsSyEHg9CPxqPQ9EstKcPbrmMdiBkVhCpK1jeVON72M7QdCOl6evnyPLJjhn61m6mPtGo2SKCSlwjgA4PB7Gum1nUVctsG0dMZritTvHtH+1LtLxsGUN0JzWGrlZGrtGN2aXxKjMEMs/Aa42QnHfGTjPpj8zXmuK2Nd1q81qZXvHG1OFRegrJI4r18PTdOFnueNiqqqzvHZEZFNIxUpFMIrc5iMimkVIfemkUARkU0ipCKaRQBERTGFTEUwikMiIppFSEU1hQBERTCKkIppoAZjkfWilH3h9aKBHWEcmjHFPI+Y0YqhDMUuOKdjBpcUAMI4pMVIRSEUAMxRin4pCKBjMUYp4FLjAy3A96AI8UuDVS81bT7L/j6vbeMjsXGfyHNZUvjLQ0JH2pn/wByJjSA38Yrze6mbw54puEXIt3YSKPQNz/iK1dT8f2kcZGnW8ssvQNL8qj3x1P6Vwd5qFzqN1JPeSmSVu57D0A7ComlJWZcJODuj0PxpqKXHhnfCw+fANbv7PWoCx1MmZ8Rl8HB6cV5BLfTPYLbMSYw2a2/AEOp3WuxRaZP5Bb70jDIA+nc1yuly02jtjXU6qfyPqPWLgpFM1rMvmp8yAH7w+lVdP1wXNrgcZHIPUGsvwvouipcW2tlbibUPL2GSeYsAeh+XpU80FvHfzPAwHmEttHY964HG2qPUU1syxM5ckk8CsPW7Y3Vu8SfeKlseuOcVrvIqp1qLTALmW8m4McYSMZ6Fi44/IGrwseaojnxUrU2ccumST2cctmrEkco3OPpVufS7WLTUYPM9wVBLKCVPqOlWdCnW2mEaZf5ivJzjn8qteJ5Z9PhjvdMSPaHCTL1Cg9GA+uB+te27I8M42ctDMY5Y5F7hmXGRSkcVpXN99sjd544GOf4Vxx/SsWdgsm5UZd3GBRa4EpFNIqITnOMlsf7NSoS7FQrZAz+FKwDSKYRVqe3mgIE8UkZIyA6kZH41ARSAiIppFSEU0ikMiIpjCpSKYetAERFMNSkUwigCPHI+tFO7j60UAdcRyaMU8jk0mKokbilIp2OaXFADMUEU8CkIoAjxiquqXS2Gnz3Ui5Ea5Cj+I9APzNXcc1zvjaQDT7SAnAnuUU/QZP+FAGVeSa3eWEUqXTxCRTIVhXaQM4AB64rh9Uj1EORcz3Eq5/jdjXtNvYq0KJsJCQxhiDkjjP9aytX0NJI2XZnI655pMZ4mcg89aK3fEWkPZTt8v6dawqkYUA4OR1oooAuQbXYNxj0PrWn4c1y/wBH1SG4sEQzIflVxkHPasNGw/sa63wmmnXrpDf7RKp+UnowrOo0ldq5tRu5JJ2Z6b4d13W75HV9Rs9OjLZEEapKxJ5PPRf1roY9Ne0m877fPcknJEm3j8gKwNC0fQba83wqIXAzlSOa3dU1eytUEVuys54VQep9a82cr6RR66294W6uZZnEEAzIeOSABn3NdHf26+HdDsbd2PnyX8Mcobg+YTllwehAAHXDAbhVjwVpbW9vHfShvtE2WjAALHjJI5wzAZJiYA4xjk1l/EuVVuPC9omAsupBsIcjakbkAZ525PQ8qdy+lejhKHs48z3PLxVfnlyrYwoAw1iTOPlkBG/oPb3/AArf1oeVC4ODG7EFQOoxzWcYJV1W5nWNNyfMQRtEinkfj1qz4llVLQl8BHjyCTjOORk/0FdLOY4yF0gupYoSJYckIw5IB7H3qdbJ5ow7hCA33cY4Ix0rl01BrOK5udp2KjMAPXGAfzNdd8OrhLzw3ZNPud41MbEn+6cf4UrgLbaMRMN24oRlmPpitHQdKjGpDgFbXCswXgyYzj6AHp6n2rTdwqCQ4EcWXYng7Rz0+lM8Pq8enJNMxDylpXHfcTuP48/pRcRpalbQ3tube7AaPn5h1U+o9+a81vbd7W5khk+8pxnsR2I+tdTPqE+oXLw2zgWyPiWc8Kmew9WI7CqHjK38rUIWXOwxBAT6r1/mKprQDnCKaakI5phFQBERTTUpqMikMjIphqUimEUARgciilxyKKAOxI5NJinkcmkHWqJG4pcU7FLigBoFIRzTwMUhHNADCK4Xx1qK/wBt6XZBwVjJlkUdQTwMntxn867PU7tLCxmuZQWEYyFHVj2H4mvENQubxNbe7u/+Poyeac9M+n07UmNH0DafJvCgZASPGckfKMZFQ29zBqFtJJZ/vI0cxljkElSQcD6g1leH9SgvLp5YydrwwzKrHp8mCPfBXFO8MoEl1u3cyfur+QrjggOof+ZNAzN8UaVE1o7zBUAXcXPSvKNQ0yWJndUYJnjI617rqtn/AGnYSW0rYV1wHA5HcN+Brio7KS4tJrO6h2ahE+2WMn5QP7w/2T2xmiwHllFdVrfhqSEs8I+UVy8iNG5VhgipAbU8UjIQUJBHPFQCp4FDMueh65oA6jw9/bWtTSQ2k4zDG0rFiFwo6nceB+NeqfCjwhcXN02o61EDbQYZY5Mv5x7M4B3eT1JZc9M9Ovm6LCmgizhkeKa5O4svHyjpu9cnj2GRXdfBjxnd6VqkXhjxBcE2srZsJJZCvlyk8qknVN/AyeAeCMHgVOCexftJW3PdZCB5kkrghlDO0x3bl6q0hX76cbhKvzLhQ1eY+Prtbz4k+FrDLM0MU9xIjkFgxG0bsfxYXlhw3Dd67TU9Q/ebI3O5GZywj27W/icJ/Cw/jQcMuCOleM2epjUvjXKVYLFbQtbRhWDKAq9Ae65zj0GB2reStEzPV5FZzuTad3GO459a4jx1czyfuVR9iJjOw5HrXXNexxLEI0JlIBAI9zyT+VUlhLZ87DMeTnnJ+lZsDx/ULCe0tvOIeSH5WMbdwM5I9sGuy+GqJHo0iwljA07Mm7njaM1R8RQPp+myQsyu9o++3ZhyYyP9WfXrj8KteBHhWyeWKMQAyljGqkbTt5/DikM7G8K/Yp0DKJZiIgeudxGf0BqS7ZJ8WMchiVly8iDLKvsOxOP51j6tqSWsttHhmkjOdqjqxyP0BJ/Gn6PJ9ktTcXbH96eTjLOT6D8gB7Z707AXNLtIo7ZLl9ljp9vzBGT95j/y0Y9yeorE8RSoyxKryyEkuC6ldvY8H16+vc4ziulso3uJRcagN3lcxQggqnufVv5dqzPHK7FtyM/vWZic5HHt+NV0EcgRTCKlYUw1AEZqMipSKYRQBGRTCKkIphFICPHI+tFOHUfWigZ2RHJpMVIRyaTFUSNpcUpFLigBuKTHNSYrL1rUhZRiKHDXcp2xqeQCe59v50Ac54o1W1Oqw2l5I6WUTnfJH8wWTGMOOwGcjFR+LfD1rf6IuowurGAK0kkfO6POGI9cDmrcNgLZVt7t0ZypzMeQznkhvUE9+36FlkH0Z5ljhc2bcTWeM8c5ZB+eVHBzkUmM47w1qFzofiuC3uJSyxE2+R0Kk5BHtk5H1r0fQp1HijXgCNw8hyh5ByhH+FeT+JvLS8tp7Zw6hAgcHO4IcKf++dv5V2nw81Jr7xZfkDc0sMQxnk7cD+tCGd+rjcyxlGdThxjofSo5bdd64Ubxk5OO/wD+ulv7eT7QLm3ZI5ydmD0kXHQ/T1oMn+qgyWfcAz7cDbg//WpiKOoaesm5Cu7aATnj6Vx+t+DI7h/Mi+XPYda9FmZWiEYXHsOaUpG1ujKOp5HTp6Z/OgDzjTfh4J/MjctuIwpH5f5xXM+I9An0G4WC6iKTiP51IxyCRkDrggA84zmvdoLaCaJ4rmDz7eTCvGFJ3DIOMAg/lXB/EXw/BpelyTRfZbczSKVssJ54VV+/95nA55zxxVKOlwPOri6kg1aOFZBshRIQAeOmT+pJz6812Wo28er6A7Oo+2RKHifGTuH9D3/CuHvU+3eJJUtGD+bcERkZwRnj8K9C0GWUP/ZzyQPKIQSTI4+U5yDkcD5efw57Vk9xnpEmqlPCB16JJ5MWS3PqysFGMt/CyE8E8MpA64rxP4Y3Lr45tLqUgtKzg4wMlge1eqanaS23ws1aK78ueO0szBDKqLnb5iscbmDYGcDCkjnnFeReFrqOx8QaY5DFFmUseR1OP61tUd2hJHsmr38mnahCJHDRS8KcYIPofxrbiYT7X39sDJxjp+dc38Q4iLKKeFcKH3jpxzV7SrkzaQjKx34z14PFQwKGuW6SStJNuIhBZQfuj39+KNCs00+yuA4wEJkOQc4/yan1SI6hplyI2CysAFGemKbHgQSJdSLGv+r3K20Egdy3AAO0E/7We1DGUrNYw39oaiGaSUkpEoOST0GPXIebHyoDtReOmT0Hqep9AOtOdJ7e5F1bSvcSSriOWYglUKq3AHAJ3LnvzjtWzptvDCC8gkklcZMhHQ9OPSi4Gxp91OYN0sY4AXCDag4IwCcE/gKxvGLSyRWzPEFVGKk7gTz3+lXTewySEo0jNjBW3+b8z0H51T1e0vb2FF8tRggndICTjoeKrcRyxprDipDkFgQQwOCD2NMI5qAIyKYwqQ0w0ARGmmpDTDQBH3H1op38Q+tFIZ//9k=
    &<公共请求参数>

    输出示例

    {
      "Response": {
        "Person": {
          "PersonId": "10703",
          "Name": "张三",
          "Description": "华语影视男演员、导演、制片人",
          "FaceInfoSet": [
            {
              "FaceId": "10109",
              "Url": "http://1251659802.vod2.myqcloud.com/vodcq1251659802/ai_samples/251006362/faces/15517827183907093125.jpeg"
            }
          ],
          "TagSet": [
            "美国",
            "明星"
          ],
          "UsageSet": [
            "Recognition.Face",
            "Review.Face"
          ],
          "CreateTime": "2019-01-16T11:34:46Z",
          "UpdateTime": "2019-01-16T11:34:46Z"
        },
        "FailFaceInfoSet": [
          {
            "Index": 1,
            "ErrCode": 18004,
            "Message": "face picture format error"
          }
        ],
        "RequestId": "2e63f898-cafd-4840-a17d-b8db9f02a9d6"
      }
    }

    5. 开发者资源

    API Explorer

    该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

    SDK

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

    命令行工具

    6. 错误码

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

    错误码 描述
    InternalError 内部错误。
    InvalidParameterValue 参数取值错误。
    InvalidParameterValue.FaceDuplicate 参数值错误:人脸重复。
    InvalidParameterValue.PicFormatError 参数值错误:人脸图片格式错误。