human: 如何处理七牛云的直播云创建云导播

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 >
[云导播API](https://developer.qiniu.com/pili/api/4703/caster-api) >
[云导播管理API](https://developer.qiniu.com/pili/api/4704/caster-contral-api) >
创建云导播

#  创建云导播

最近更新时间: 2019-01-07 10:40:34

# API说明

创建云导播，并开启云导播(创建云导播后，默认开启1小时)  
每位用户有创建云导播数量的限制，限制默认为1，如果需要调整限制，可以联系技术支持

# 请求包

    
    
    POST /v1/casters
    Host: pili-caster.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    {
      "name": "",
      "staticKey": "",
      "monitors": {},
      "canvas": {},
      "pvwOutput": {},
      "pgmOutput": {},
      "layouts": {},
        "storage": {}
    }
    

# 请求参数

参数名称 | 必填 | 字段类型 | 取值范围 | 说明  
---|---|---|---|---  
name | 是 | string | 允许1-18位，小写字母与数字组合 | 云导播名称  
staticKey | 否 | string | 默认值为16位小写英文+数字随机值 | 云导播静态密钥，留空会生成随机密钥  
monitors | 否 | object | - | 监视器配置，支持0-7共8个频道，详细参数见[监视器配置(monitors)详细参数](https://developer.qiniu.com/pili/api/4735#monitors)  
canvas | 否 | object | - | 画布配置，详细参数见[画布配置(canvas)详细参数](https://developer.qiniu.com/pili/api/4735#canvas)  
pvwOutput | 否 | object | - | PVW输出配置，详细配置见[PVW输出配置(pvwOutput)详细参数](https://developer.qiniu.com/pili/api/4735#pvwOutput)  
pgmOutput | 否 | object | - | PGM输出配置，详细配置见[PGM输出配置(pgmOutput)详细参数](https://developer.qiniu.com/pili/api/4735#pgmOutput)  
layouts | 否 | object | - | 布局配置，支持0-7共8组配置，详细参数见[布局配置(layouts)详细参数](https://developer.qiniu.com/pili/api/4735#layouts)  
storage | 否 | object | - | 上传配置，支持Bucket和Domain配置，详细参数见[上传配置(storage)详细参数](https://developer.qiniu.com/pili/api/4735#storage)  
  
# 返回包

    
    
    200 OK
    {
      "id": "<id>",
      "uid": <uid>,
      "name": "<name>",
      "staticKey": "<staticKey>",
      "monitors": {
        "0": {
          "url": "<url>",
          "vol": 100,
          "muted": false
        },
        "1": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "2": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "3": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "4": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "5": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "6": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        },
        "7": {
          "url": "<url>",
          "vol": 100,
          "muted": true
        }
      },
      "canvas": {
        "resolution": "<resolution>",
        "height": <height>,
        "width": <width>
      },
      "timeSwitch": {
        "start": <start>,
        "stop": <stop>
      },
      "pvwOutput": {
        "play": "<url>",
        "channel": 0,
        "layout": 0
      },
      "pgmOutput": {
        "closed": false,
        "publish": "<url>",
        "ab": 64,
        "vb": 1000,
        "channel": 0,
        "overlay": {},
        "text": {},
        "emergencyMode": false,
        "emergencyChannel": 0,
        "delay": 0
      },
      "layouts": {
        "0": {
          "title": "<title>",
          "overlay": {},
          "text": {},
          "updateAt": <timestamp>
        }
      },
        "storage": {
            "bucket":"",
            "domain":""
        }
      "stage": 1,
      "status": "pending",
      "createAt": <timestamp>,
      "updateAt": <timestamp>
    }
    

# 返回参数

  * 详细参数说明见[云导播参数说明](https://developer.qiniu.com/pili/api/4735#caster)

# 相关接口

  * [创建云导播 POST /v1/casters](https://developer.qiniu.com/pili/api/4709)
  * [更新云导播 POST /v1/casters/<CasterID>](https://developer.qiniu.com/pili/api/4711)
  * [删除云导播 DELETE /v1/casters/<CasterID>](https://developer.qiniu.com/pili/api/4712)
  * [开启云导播 POST /v1/casters/<CasterID>/start](https://developer.qiniu.com/pili/api/4713)
  * [关闭云导播 POST /v1/casters/<CasterID>/stop](https://developer.qiniu.com/pili/api/4714)
  * [云导播列表 GET /v1/casters](https://developer.qiniu.com/pili/api/4715)
  * [云导播信息 GET /v1/casters/<CasterID>](https://developer.qiniu.com/pili/api/4716)

以上内容是否对您有帮助？