添加人脸分析任务
<p>[TOC]</p>
<h1>简要描述</h1>
<ul>
<li>通过该接口创建人物分析任务</li>
</ul>
<h1>请求URL</h1>
<ul>
<li><code>http://IP:PORT/LVFaceService/task/v1/face_analyze</code></li>
</ul>
<h1>请求方式</h1>
<ul>
<li>post</li>
</ul>
<h1>参数</h1>
<h2>请求参数</h2>
<h3>Body 参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">task_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>任务ID</td>
<td>调用方要保证taskid的唯一性，可以使用uuid，英文、数字、下划线(_)、中划线（-）组成，不能包含中文及其他特殊字符</td>
</tr>
<tr>
<td style="text-align: left;">file_path</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>分析文件</td>
<td>当前只支持文件url，可以传递图片或视频</td>
</tr>
<tr>
<td style="text-align: left;">resource_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>资源ID</td>
<td>待分析文件（file_path）对应的业务资源ID，当is_use_search_db为true时，必须填写，否则可以不填</td>
</tr>
<tr>
<td style="text-align: left;">sync</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td>是否同步返回</td>
<td>只有图片资源分析时有效；图片分析支持同步返回结果，需要应用层等待分析结果</td>
</tr>
<tr>
<td style="text-align: left;">person_db_ids</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string array</td>
<td>人物库ID列表</td>
<td>用于人脸识别，当前值支持一个，如果传递多个，使用第一个</td>
</tr>
<tr>
<td style="text-align: left;">search_db_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>搜索库</td>
<td>如果分析的资源需要在后续进行人脸检索或人脸翻库，需要指定这个ID，否则不需要；搜索库会自动在引擎端创建</td>
</tr>
<tr>
<td style="text-align: left;">recognite_min_simi</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">float</td>
<td>人脸识别最小相似度</td>
<td>默认0.71，分析人脸与人物库中人物的最小相似度</td>
</tr>
<tr>
<td style="text-align: left;">aggregate_min_simi</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">float</td>
<td>人物聚合相似度</td>
<td>默认0.71，用于视频文件人脸分析阶段的聚合参考最小相似度，大于该值得人脸会被聚合到一起</td>
</tr>
<tr>
<td style="text-align: left;">analyze_interval_ms</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">integer</td>
<td>视频分析间隔</td>
<td>默认1000，单位ms；指定视频文件抽帧分析间隔</td>
</tr>
<tr>
<td style="text-align: left;">merge_max_interval_ms</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">integer</td>
<td>视频人脸聚合最大时间间隔</td>
<td>默认1000，单位ms；指定人脸聚合阶段人脸时间段合并的最大间隔，超出这个间隔，认为是不同的片段</td>
</tr>
<tr>
<td style="text-align: left;">recog_model</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>人脸向量提取模型</td>
<td>默认arc</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">is_use_search_db</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td>是否使用搜索库</td>
<td>如果为true，分析的人脸内容将录入search_db_id指定的搜索库中，参与后续的检索或翻库；否则，分析数据不会保留</td>
</tr>
</tbody>
</table>
<h3>请求样例</h3>
<pre><code> post http://IP:PORT/LVFaceService/task/v1/face_analyze
{
&quot;task_id&quot;: &quot;task001&quot;,
&quot;file_path&quot;: &quot;http://114.255.110.195:8187/LVCallbackServer/00_FaceTest/LJH.mp4&quot;,
&quot;resource_id&quot;: &quot;resource001&quot;,
&quot;person_db_ids&quot;: [
&quot;PersonDB001&quot;
],
&quot;search_db_id&quot;: &quot;SearchDB001&quot;,
&quot;is_use_search_db&quot;: true
}</code></pre>
<h5>返回体示例</h5>
<pre><code>{
&quot;task_id&quot;: &quot;task001&quot;
}
</code></pre>
<h5>返回体说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">error</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>错误信息</td>
<td>如果返回该字段，说明服务报错；接口参见 ErrorInfo</td>
</tr>
<tr>
<td style="text-align: left;">task_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>任务ID</td>
<td>-</td>
</tr>
</tbody>
</table>
<h5>ErrorInfo</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>错误码</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">error_desc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>错误描述</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>
<p>[TOC]</p>
<h1>简要描述</h1>
<ul>
<li>通过该接口创建人物</li>
</ul>
<h1>请求URL</h1>
<ul>
<li><code>http://IP:PORT/LVFaceService/person</code></li>
</ul>
<h1>请求方式</h1>
<ul>
<li>put </li>
</ul>
<h1>参数</h1>
<h2>请求参数</h2>
<h3>Body 参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">db_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>库ID</td>
<td>英文、数字、下划线(_)、中划线（-）组成，不能包含中文及其他特殊字符</td>
</tr>
<tr>
<td style="text-align: left;">person_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>人物ID</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">person_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>人物姓名</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">person_des</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>人物描述</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>用户数据</td>
<td>用户自定义数据</td>
</tr>
</tbody>
</table>
<h3>请求样例</h3>
<pre><code> put http://IP:PORT/LVFaceService/person
{
&quot;db_id&quot;: &quot;test001&quot;,
&quot;person_id&quot;: &quot;person001&quot;,
&quot;person_name&quot;: &quot;测试人物001&quot;,
&quot;data&quot;: {
&quot;testData&quot;:&quot;&quot;
}
}</code></pre>
<h5>返回体示例</h5>
<pre><code>{
&quot;db_id&quot;: &quot;test001&quot;,
&quot;person_id&quot;: &quot;person001&quot;,
&quot;person_name&quot;: &quot;测试人物001&quot;,
&quot;data&quot;: {
&quot;testData&quot;: &quot;&quot;
},
&quot;create_time&quot;: &quot;2024-10-21 13:38:27&quot;
}</code></pre>
<h5>返回体说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">error</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>错误信息</td>
<td>如果返回该字段，说明服务报错；接口参见 ErrorInfo</td>
</tr>
<tr>
<td style="text-align: left;">db_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>库ID</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">person_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>人物名称</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">person_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>人物姓名描述</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>用户数据</td>
<td>用户自定义数据结构</td>
</tr>
</tbody>
</table>
<h5>ErrorInfo</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>错误码</td>
<td>--</td>
</tr>
<tr>
<td style="text-align: left;">error_desc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>错误描述</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>