StreamLive API Reference
StreamLive의 API 서비스 코드는 mdl, API 버전은 2020-03-26입니다. 보안 그룹 → 입력 → 채널 순서로 생성하고, 채널을 시작한 뒤 실제 수신과 재생을 확인합니다.
호출 규격
| 항목 | 값 |
|---|---|
| Endpoint | POST https://mdl.tencentcloudapi.com |
| Action | 아래 API 목록 참조 |
| 요청 서명 | 공식 SDK / TCCLI의 Tencent Cloud API 3.0 서명 사용 |
기본 정보
| 항목 | 값 |
|---|---|
| API 서비스 코드 | mdl |
| API 버전 | 2020-03-26 |
| 인증 | Tencent Cloud API 3.0 / TC3-HMAC-SHA256 |
| 호출 도구 | Tencent Cloud SDK / TCCLI |
실행 전 준비
TCCLI 인증과 권한을 설정합니다. 예제 리전은 ap-seoul이며 REPLACE_ 식별자와 문서용 IP 203.0.113.10/32는 실제 값으로 교체합니다. 생성 명령을 다시 실행하기 전 기존 생성 결과를 확인합니다.
API 목록과 요청 파라미터
| Action | 동작 |
|---|---|
CreateStreamLiveInputSecurityGroup | 생성 |
DescribeStreamLiveInputSecurityGroups | 조회 |
CreateStreamLiveInput | 생성 |
DescribeStreamLiveInput | 조회 |
CreateStreamLiveChannel | 생성 |
DescribeStreamLiveChannel | 조회 |
StartStreamLiveChannel | 시작 |
StopStreamLiveChannel | 정지 |
응답과 실행 흐름
생성 응답에서 반환된 리소스 ID를 보관하고 조회 API로 상태를 확인하십시오. 생성 요청의 성공과 실제 입력 수신·출력 전송의 성공은 구분합니다. 다음 단계는 해당 리소스의 상태를 확인한 뒤 실행하십시오.
오류와 호출 제한
연결 확인
| 증상 | 확인 사항 |
|---|---|
| CLI Action | 정확한 Action 이름과 TCCLI 버전 확인 |
| 입력 신호 — | 송출 주소, AppName / StreamName, 입력 보안 그룹 |
| 템플릿 이름 | 영문 / 숫자 1~20자 |
| 화질 하나만 출력 | Outputs와 각 템플릿 연결, 실제 마스터 플레이리스트 |
| 채널 수정 | 작업 대상과 필요한 채널 상태 확인 |
요청 문의에는 Action, 리전, 응답 코드, RequestId, 발생 시각을 전달합니다. 테스트 후 전송 / 저장 / 배포 리소스를 정리합니다.
요청 예제
1. 입력 보안 그룹
보안 그룹 생성 API는 CreateStreamLiveInputSecurityGroup입니다.
tccli mdl CreateStreamLiveInputSecurityGroup --region ap-seoul \
--Name demo_source_allowlist --Whitelist '["203.0.113.10/32"]'실제 송출 측의 공인 IP를 허용합니다. StreamLink가 앞단에 있으면 시청자나 작업 PC의 IP가 아니라 StreamLink에서 연결해 오는 송출 측 주소를 확인해야 합니다.
| 동작 | Action |
|---|---|
| 생성 | CreateStreamLiveInputSecurityGroup |
| 목록 조회 | DescribeStreamLiveInputSecurityGroups |
| 상세 조회 | DescribeStreamLiveInputSecurityGroup |
| 수정 | ModifyStreamLiveInputSecurityGroup |
| 삭제 | DeleteStreamLiveInputSecurityGroup |
tccli mdl DescribeStreamLiveInputSecurityGroups --region ap-seoul생성 또는 조회 응답에서 사용할 보안 그룹 ID를 확인합니다. 이 입력 보안 그룹은 일반 CVM/VPC 보안 그룹과 구분되는 StreamLive 리소스입니다.
2. RTMP 입력 생성
tccli mdl CreateStreamLiveInput --region ap-seoul \
--Name demo_input --Type RTMP_PUSH \
--SecurityGroupIds '["REPLACE_SECURITY_GROUP_ID"]' \
--InputSettings '[{"AppName":"demo","StreamName":"source"}]'위 설정은 RTMP_PUSH 예제입니다. Pull 유형은 원본 URL, SRT 유형은 해당 SRT 설정을 확인합니다. 하나의 입력에는 보안 그룹 하나를 연결할 수 있습니다.
tccli mdl DescribeStreamLiveInput --region ap-seoul --Id REPLACE_INPUT_ID조회 응답 또는 콘솔에 표시되는 송출 주소를 사용합니다.
3. 채널 생성
채널 구성의 JSON을 channel.json으로 저장하고 입력 ID와 StreamPackage 채널 ID를 교체합니다.
tccli mdl CreateStreamLiveChannel --region ap-seoul --cli-input-json file://channel.json| 설정 | 역할 |
|---|---|
AttachedInputs | 연결할 입력 |
AVTemplates | 영상 / 오디오 결합형 템플릿 |
AudioTemplates, VideoTemplates | 분리형 오디오 / 영상 템플릿 |
OutputGroups | 출력 방식, 화질별 출력, 목적지 |
결합형 예제에서는 화질별 Output에 템플릿 하나씩 연결합니다.
4. 조회 / 시작
tccli mdl DescribeStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID
tccli mdl StartStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID실행 후 채널 상태, 입력 신호, 출력 목록, 패키저 수신, 플레이어 재생을 확인합니다.
5. 정지와 변경
tccli mdl StopStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID채널 정지가 필요한 변경은 점검 시간 또는 별도 경로를 준비한 뒤 IDLE 상태에서 적용합니다.