文档首页/ 视频智能分析服务 VIAS/ API参考/ 平台API/ 视频中心/ 创建视频源
更新时间：2025-03-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建视频源

功能介绍

创建视频源。

调用方法

请参见如何调用API。

URI

POST /v2/{project_id}/source

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

用户项目ID，获取方法参见获取项目ID和名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token，获取方法参见认证鉴权。
表3 请求Body参数

参数

是否必选

参数类型

描述

video_source_name

是

String

视频源名称，只支持中文、英文字母（a-z,A-Z）、数字、特殊字符（空格.-_() （）），不能以空格开头和结尾。

access_type

是

String

接入类型（cloud、edge）。

type

是

String

类型:obs、vcn、url、restful、camera。

latitude

否

String

视频源的地理位置信息，纬度，-90.00000~90.00000。

longitude

否

String

视频源的地理位置信息，经度，-180.00000~180.00000。

video_group_ids

否

Array of strings

系统中所有的视频源分组，只能由小写英文字母(a~z)、数字(0~9)、中划线(-)、下划线(_)组成，长度范围为[4, 36]。

type_config

是

String

视频源配置信息xml

url形式：

<type>URL</type>

<config>

<URL_ADDRESS></URL_ADDRESS>

</config>

vcn形式：

<type>VCN</type>

<config>

<DATA_SOURCE_ID></DATA_SOURCE_ID>

<STREAM_TYPE></STREAM_TYPE>

<IP></IP>

<PORT></PORT>

<USER_NAME></USER_NAME>

<PASSWORD></PASSWORD>

</config>

restful形式：

<type>RESTFUL</type>

<config>

<HTTP_CHECK></HTTP_CHECK>

<URL></URL>

<RTSP_URL></RTSP_URL>

</config>

camera形式：

<type>CAMERA</type>

<config>

<EDGE_CAMERA_ID></EDGE_CAMERA_ID>

</config>

tag

否

Array of strings

视频源标签，标签最多选择4个，标签内容只能由中文， 英文字母(a~z, A~Z)、数字(0~9)、中划线(-)、下划线(_)组成。

  • 最小长度：1
  • 最大长度：10

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

video_source_id

String

视频源id

请求示例

创建视频源请求体

/v2/{project_id}/source/sources/{video_source_id}

{
  "video_source_name" : "url_test",
  "access_type" : "cloud",
  "type" : "url",
  "longitude" : "",
  "latitude" : "",
  "tag" : [ ],
  "video_group_ids" : [ ],
  "type_config" : "<type_config>        <url_address>rtsp://12.12.12.12:333</url_address>      </type_config>"
}

响应示例

状态码： 200

视频源信息

{
  "video_source_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx"
}

状态码

状态码

描述

200

视频源信息
父主题： 视频中心

相关文档