此接口只用于创建视频实体,不负责文件传输。开发者需先通过 视频分片上传 接口将文件上传于腾讯云,此接口创建video实体。
POST https://lxapi.lexiangla.com/cgi-bin/v1/videos
headers.Authorization: Bearer {access_token}
headers.StaffID: {StaffID}
document
{
"data":{
"type":"video",
"attributes":{
"vod_file_id":"your_vod_file_id",
"name":"视频名称",
"type":"mp4"
}
}
}
参数 | 是否必须 | 默认值 | 说明 |
---|---|---|---|
vod_file_id | 是 | 无 | 视频分片上传中获取的data.fileId |
name | 是 | 无 | 视频名称,同步骤视频分片上传中文档videoName 说明 |
type | 否 | 无 | 视频的文件类型,同步骤视频分片上传中文档videoType 说明 |
size | 否 | 无 | 视频的文件大小,同步骤视频分片上传中文档videoSize 说明 |
$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$file_path = './345.mp3'; // 文件的绝对路径
$cover_path = '';
$response = $Lxapi->uploadVideo('ThreeZhang', $file_path, $cover_path);
document
{
"data":{
"type":"video",
"id":"756972cefac711e9b51e10e7c61c70fc",
"attributes":{
"name":"视频名称",
"type":"mp4",
"vod_file_id": "your_vod_file_id"
}
}
}
GET https://lxapi.lexiangla.com/cgi-bin/v1/videos/{id}
参数 | 是否必须 | 默认值 | 说明 |
---|---|---|---|
id | 是 | 无 | video ID |
$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('videos/6f230e7e7df911eaa5b40242ac180005');
document
{
"data": {
"type": "video",
"id": "6f230e7e7df911eaa5b40242ac180005",
"attributes": {
"name": "测试视频",
"type": "MP4",
"vod_file_id": "5285890801312622820"
},
"links": {
"download": "http://1400311082.vod2.myqcloud.com/ff2d1f96vodcq1400311082/3708a57d5285890801312622820/ui4eR9aGRTQA.mp4?t=5e953515&us=csd6yo7sbt&sign=239fa8c9c877fdee7264b6d65bb636c1"
}
}
}
参数 | 说明 |
---|---|
name | 视频名称 |
type | 视频类型 |
vod_file_id | 内部存储ID |
links.download | 视频下载地址,有效期1小时 |