AddLiveStreamUrl.ashx 创建直播流地址
创建一条直播推拉流地址，支持推流协议 RTMP / SRT，支持拉流协议 RTMP / SRT / FLV / M3U8 / ARTC 多种协议；创建成功后返回多协议推拉流链接。本接口仅支持单条流创建，不支持批量操作。
请求信息
| 项目 |
内容 |
| 请求地址 |
http://openapi.chunyuyun.cn/AddLiveStreamUrl.ashx |
| 请求方式 |
POST Form表单 |
| 鉴权方式 |
HMAC-SHA256签名，签名规则参考【签名算法说明】章节 |
请求参数
| 参数名 |
是否必填 |
说明 |
| openapi_key |
是 |
开放密钥 AccessKey |
| Timestamp |
是 |
Unix秒级时间戳 |
| Nonce |
是 |
随机字符串，推荐GUID |
| Signature |
是 |
签名结果 |
| livecenter |
是 |
直播中心标识，可选值：cn-beijing、cn-qingdao、cn-shanghai、cn-shenzhen、cn-quanqiu |
| notes |
是 |
备注/流标题，支持中文，用于后台区分流 |
请求示例
POST http://openapi.chunyuyun.cn/AddLiveStreamUrl.ashx
Form参数：
openapi_key=AKxxxx
Timestamp=1769932800
Nonce=550e8400-e29b-41d4-a716-446655440000
livecenter=cn-beijing
notes=直播间测试标题
Signature=【签名结果，参考签名文档】
返回参数说明
| 字段 |
说明 |
| orderno |
流唯一编号（订单号），后续查询、禁用、回收接口使用该编号 |
| push_rtmp_url |
RTMP推流地址 |
| push_srt_url |
SRT推流地址 |
| pull_rtmp_url |
RTMP播放地址 |
| pull_srt_url |
SRT播放地址 |
| pull_flv_url |
FLV格式播放地址 |
| pull_m3u8_url |
M3U8格式播放地址 |
| pull_artc_url |
ARTC低延迟播放地址 |
成功返回示例
{
"code": 0,
"msg": "success",
"data": [
{"orderno": "YSCYY202611061630208888"},
{"push_rtmp_url": "rtmp://xxx/live/xxxx"},
{"push_srt_url": "srt://xxx:9000?streamid=xxxx"},
{"pull_rtmp_url": "rtmp://xxx/live/xxxx"},
{"pull_srt_url": "srt://xxx:9000?streamid=xxxx"},
{"pull_flv_url": "http://xxx/live/xxxx.flv"},
{"pull_m3u8_url": "http://xxx/live/xxxx.m3u8"},
{"pull_artc_url": "artc://xxx/live/xxxx"}
]
}
本接口专属错误码
| code |
说明 |
| 0 |
创建成功 |
| -1 |
数据库写入失败，添加流地址失败 |
| -2 |
当前账号可用流量不足 |
| -3 |
账号下有效流地址数量已达到上限 |
| -4 |
openapi_key无效 |
| -5 |
访问受限，请联系客服 |
| -6 |
直播中心无效 |
⚠️ 注意事项：
1. 流默认有效期 30天，到期自动失效；
2. 计费方式默认流量计费；
3. orderno 是流唯一标识，后续所有对流操作接口都依赖该编号；
4. 流量不足时会直接返回失败，不会创建流；
5. 所有推拉流地址自带鉴权，不可篡改。