创建视频流

功能介绍

该接口用于创建视频流。包括RTMP以及HTTP-FLV类型视频流。

• 创建RTMP视频流时，用户可根据实际需求选择是否配置秘钥，如果配置了秘钥，则进行RTMP推流时需要提供认证Token。如果不配置该参数，则推流时不需要进行认证。

• 创建HTTP-FLV视频流时，需要HTTP-FLV视频流的拉流地址，且地址必须是http或https协议的合法URL。

自定义流名称只能使用英文字母a~z，A-Z）、数字（0~9）以及连接符（-、_），连接符（-、__）不能连续出现、不能单独注册，也不能放在开头和结尾。长度不低于 8，不超过128个字符。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/streams

请求参数

响应参数

状态码： 201

请求示例

• RTMP

  POST /v1/3266392d188c47d09948b1**********/streams
  
  {
    "name" : "stream_test1",
    "access_type" : "RTMP",
    "encode_type" : "H264",
    "share_type" : "PUBLIC",
    "access_key" : "ALKJOWLKJSDNFGO******KSJDF",
    "description" : "",
    "tag" : [ {
      "key" : "group",
      "value" : "number1"
    } ]
  }

• HTTP-FLV

  POST /v1/3266392d188c47d09948b1**********/streams
  
  {
    "name" : "stream_test2",
    "access_type" : "HTTP-FLV",
    "encode_type" : "H264",
    "share_type" : "PUBLIC",
    "url" : "https://xxxxxxxx.com/live",
    "description" : "",
    "tag" : [ {
      "key" : "group",
      "value" : "number1"
    } ]
  }

响应示例

状态码： 201

正常

• 示例 1

  {
    "stream_id" : "stream-0BOPSRsT",
    "name" : "stream_test1",
    "encode_type" : "H264",
    "access_type" : "RTMP",
    "access_key" : "ALKJOWLKJSDNFGO******KSJDF",
    "share_type" : "PUBLIC",
    "state" : "STOPPED",
    "created_at" : "2018-06-12T13:00:01Z",
    "updated_at" : "2018-06-12T13:00:01Z",
    "description" : "",
    "tag" : [ {
      "key" : "group",
      "value" : "number1"
    } ]
  }

• 示例 2

  {
    "stream_id" : "stream-9IzU3TdL",
    "name" : "stream_test2",
    "encode_type" : "H264",
    "access_type" : "HTTP-FLV",
    "url" : "https://xxxxxxxx.com/live",
    "share_type" : "PUBLIC",
    "state" : "STOPPED",
    "created_at" : "2018-06-12T13:00:01Z",
    "updated_at" : "2018-06-12T13:00:01Z",
    "description" : "",
    "tag" : [ {
      "key" : "group",
      "value" : "number1"
    } ]
  }

状态码： 400

请求错误。具体返回错误码请参考错误码说明

{
  "error_msg" : "Invalid request parameter, url can not be null or empty when access type is HTTP-FLV.",
  "error_code" : "VIS.0005"
}

状态码