## 提交视频转码 ### 基本信息 | 属性 | 内容 | |:-------------|:--------------------------------| | 接口名称 | 提交视频转码 | | 接口版本 | v1.0 | | 接口路径 | /video_push | | 请求方法 | POST | | 接口状态 | 生产环境 | ### 接口说明 按 VIP 等级或消耗枫币提交视频加速转码。 ### 接口地址 ``` https://proapi.115.com/open/video/video_push ``` ### 请求方式 ``` POST Content-Type: multipart/form-data ``` ### 认证方式 ``` Authorization: Bearer access_token ``` ### 请求参数 | 参数名 | 类型 | 必填 | 默认值 | 说明 | 约束/示例 | |:----------|:-------|:---|:----|:----------------------------------------|:-----------------| | pick_code | string | 是 | - | 视频文件提取码 | b53gu6z3hvqji8wrm | | op | string | 是 | - | 加速转码方式,`vip_push`:按 VIP 等级加速;`pay_push`:消耗枫币加速 | vip_push | ### 请求示例 ```shell curl 'https://proapi.115.com/open/video/video_push' \ -H 'Authorization: Bearer ' \ -F 'pick_code=b53gu6z3hvqji8wrm' \ -F 'op=vip_push' ``` ### 响应字段说明 | 字段 | 类型 | 描述 | |:------|:---------|:----------------------| | state | boolean | 操作结果状态,true:成功;false:失败 | | message | string | 返回信息,成功时为空字符串 | | code | int | 错误码 | | data | object[] | 响应数据,成功时为空数组 | ### 响应示例 ```json { "state": true, "message": "", "code": 0, "data": [] } ``` ### 业务规则 - 仅支持为当前授权用户所属的视频文件提交加速转码。 - 已完成转码的视频无需重复提交。 - 两种加速转码方式均要求当前用户具备 VIP 权益;`pay_push` 在枫币余额不足时提交失败。 - 提交成功后,系统通知转码服务重新计算排队信息,并在 3 小时内记录已加速状态。 ### 注意事项 - `access_token` 通过 `Authorization` 请求头传递,请将请求示例中的占位符替换为实际访问令牌。 - 请勿对同一视频重复提交加速转码。 ### 修改历史 | 修改时间 | 修改说明 | |:-----------------------------|:-----| | 2025年04月01日(周二) 00:00:00 | 创建文档 |