视频处理
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>视频处理接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/v1/video/handle</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post ，json方式</li>
</ul>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">videourl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>视频文件下载链接</td>
</tr>
<tr>
<td style="text-align: left;">musicurl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>音频文件下载链接</td>
</tr>
<tr>
<td style="text-align: left;">modes</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">[]string</td>
<td>模式ID列表,可空，但modes和effects不可能同时为空,该值存在时，表示目标视频需要处理的各个模式，只有出现在modes中的模式才需要处理</td>
</tr>
<tr>
<td style="text-align: left;">effects</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">[]string</td>
<td>特效ID列表数组,可空,但modes和effects不可同时为空,该值存在时，表示目标视频需要处理的特效，只有出现在effects中的特效才需要处理</td>
</tr>
<tr>
<td style="text-align: left;">resolution</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>分辨率 默认0:原分辨率 ，1:480P，2:720P，3:1080P</td>
</tr>
<tr>
<td style="text-align: left;">scale</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>比例 默认0：原比例，1:全屏，2:1:2，3:1:3</td>
</tr>
<tr>
<td style="text-align: left;">taskid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>本次提交的任务ID，该值全局唯一</td>
</tr>
<tr>
<td style="text-align: left;">callbackurl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>回调结果通知url，-未传，不回调</td>
</tr>
<tr>
<td style="text-align: left;">metaurl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>视频元信息回调结果通知url，-未传，不回调</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
"code": 1000,
"msg": "success",
"data": {
"taskid":21321,
"url": "xxx"
},
"extra":{
"logid":"2020070614111601022506808001045D59",
"timestamp":1594015876138
}
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">taskid</td>
<td style="text-align: left;">string</td>
<td>任务ID,与参数中的 taskid 一致即可</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">string</td>
<td>原视频链接</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>