Referencia apiLive streams

Lives Novo V2

POST
/v2/live-streams

POST /v2/live-streams. Contrato do handler livesNovoV2. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT de usuário/console ou API token, conforme a autorização e as permissões da conta. Não enviar tokens reais nos exemplos.

Parâmetros de query

ignorar_ip?boolean
uid?string

Corpo da requisição

application/json
  1. body
accountId?string
ads?
allowPublicAccess?boolean
description?string
directoryId?string
directoryLive2Vod?string
enableAudioOnly?boolean
enableAutoStart?boolean
enableAutoStop?boolean
enableChat?boolean
enableCut?boolean
enableDvr?boolean
enableLive2vod?boolean
endingScreen?string
gaTag?string
geoAccessControl?string
geoRegionList?array<string>
googleDAI?
ipWhitelist?array<string>
latencyPreference?string
metadata?array<>
outputQualities?array<string>
pauseScreen?string
playerColor?string
playerCustomization?
referrerWhitelist?array<string>
robotCustomization?
scheduledStartTime?string
Formatodate-time
startSoonScreen?string
streamPull?boolean
streamPullSource?string
subtitles?boolean
tags?array<string>
tencentChatUserId?string
tencentChatUserSig?string
tencentGroupId?string
thumbnail?string
title?string
type?string

Corpo da resposta

Operação concluída.

application/json
  1. response
actualEndTime?string
Formatodate-time
actualStartTime?string
Formatodate-time
ads?
allowPublicAccess?boolean
assets?
createdAt?string
Formatodate-time
description?string
enableAutoStart?boolean
enableChat?boolean
gaTag?string
googleDAI?
isPaused?boolean
liveId?string
outputQualities?array<string>
playerCustomization?
rawSettings?
robotCustomization?
scheduledEndTime?string
Formatodate-time
scheduledStartTime?string
Formatodate-time
security?
status?string
streamPull?boolean
subtitles?boolean
tencentChatUserId?string
tencentChatUserSig?string
title?string
transcode?
type?string
updatedAt?string
Formatodate-time
wherebyMeetingId?string
wherebyRoomName?string
curl -X POST "https://example.com/v2/live-streams" \  -H "Content-Type: application/json" \  -d '{    "accountId": "018f0000-0000-7000-8000-000000000001",    "ads": {      "googleIMA": [],      "vast": [],      "vmap": []    },    "allowPublicAccess": false,    "description": "Exemplo sintético para documentação.",    "directoryId": "0123456789abcdefghijklmnopq",    "directoryLive2Vod": "",    "enableAudioOnly": false,    "enableAutoStart": false,    "enableAutoStop": false,    "enableChat": false,    "enableCut": false,    "enableDvr": false,    "enableLive2vod": false,    "endingScreen": "",    "gaTag": "",    "geoAccessControl": "",    "geoRegionList": [],    "googleDAI": {      "apiKey": "0123456789abcdefghijklmnopq",      "assetKey": "0123456789abcdefghijklmnopq",      "contentSourceId": "https://media.example.com/exemplo",      "enabled": false,      "type": "",      "videoId": "0123456789abcdefghijklmnopq"    },    "ipWhitelist": [],    "latencyPreference": "",    "metadata": [],    "outputQualities": [],    "pauseScreen": "",    "playerColor": "",    "playerCustomization": {      "backgroundColor": "",      "colorTone": "",      "iconTextColor": "",      "playButtonLocation": false,      "primaryColor": "",      "showConfigurations": false,      "showFullscreen": false,      "showLike": false,      "showSeekControls": false,      "showSound": false,      "showSpeed": false,      "showStatistics": false,      "showTitle": false    },    "referrerWhitelist": [],    "robotCustomization": {      "assistantAction": [],      "decreaseVolumeActions": [],      "enableVolumeActions": [],      "increaseVolumeActions": [],      "interruptAssistantActions": [],      "interruptionActions": [],      "momentSearchActions": [],      "muteVolumeActions": [],      "playbackActions": [],      "selectedImage": "https://media.example.com/exemplo",      "videoAdvanceActions": [],      "videoRewindActions": [],      "voiceAssistant": false,      "welcomePhrase": ""    },    "scheduledStartTime": "2026-01-15T12:00:00Z",    "startSoonScreen": "",    "streamPull": false,    "streamPullSource": "https://media.example.com/exemplo",    "subtitles": false,    "tags": [],    "tencentChatUserId": "0123456789abcdef01234567",    "tencentChatUserSig": "",    "tencentGroupId": "0123456789abcdef01234567",    "thumbnail": "https://media.example.com/exemplo",    "title": "Exemplo sintético",    "type": ""  }'
{  "actualEndTime": "2026-01-15T12:00:00Z",  "actualStartTime": "2026-01-15T12:00:00Z",  "ads": {    "googleIMA": [],    "vast": [],    "vmap": []  },  "assets": {    "chatIframe": "https://media.example.com/exemplo",    "endingScreen": "",    "hls": "https://media.example.com/exemplo",    "iframe": "https://media.example.com/exemplo",    "pauseScreen": "",    "player": "https://media.example.com/exemplo",    "playerColor": "",    "startSoonScreen": "",    "thumbnail": "https://media.example.com/exemplo",    "wss": ""  },  "createdAt": "2026-01-15T12:00:00Z",  "description": "Exemplo sintético para documentação.",  "enableAutoStart": false,  "enableChat": false,  "googleDAI": {    "apiKey": "0123456789abcdefghijklmnopq",    "assetKey": "0123456789abcdefghijklmnopq",    "contentSourceId": "https://media.example.com/exemplo",    "enabled": false,    "type": "",    "videoId": "0123456789abcdefghijklmnopq"  },  "isPaused": false,  "liveId": "0123456789abcdefghijklmnopq",  "outputQualities": [],  "playerCustomization": {    "backgroundColor": "",    "colorTone": "",    "iconTextColor": "",    "playButtonLocation": false,    "primaryColor": "",    "showConfigurations": false,    "showFullscreen": false,    "showLike": false,    "showSeekControls": false,    "showSound": false,    "showSpeed": false,    "showStatistics": false,    "showTitle": false  },  "rawSettings": {    "streaming": {      "geoAccessControl": "",      "geoRegionList": [],      "ipWhitelist": [],      "referrerWhitelist": [],      "streamingProfile": ""    }  },  "robotCustomization": {    "assistantAction": [],    "decreaseVolumeActions": [],    "enableVolumeActions": [],    "increaseVolumeActions": [],    "interruptAssistantActions": [],    "interruptionActions": [],    "momentSearchActions": [],    "muteVolumeActions": [],    "playbackActions": [],    "selectedImage": "https://media.example.com/exemplo",    "videoAdvanceActions": [],    "videoRewindActions": [],    "voiceAssistant": false,    "welcomePhrase": ""  },  "scheduledEndTime": "2026-01-15T12:00:00Z",  "scheduledStartTime": "2026-01-15T12:00:00Z",  "security": {    "geoAccessControl": "",    "geoRegionList": [],    "ipWhitelist": [],    "referrerWhitelist": []  },  "status": "",  "streamPull": false,  "subtitles": false,  "tencentChatUserId": "0123456789abcdef01234567",  "tencentChatUserSig": "",  "title": "Exemplo sintético",  "transcode": {    "enableAudioOnly": false,    "enableCut": false,    "enableDvr": false,    "enableLive2vod": false,    "endpoints": [],    "latencyPreference": "",    "status": []  },  "type": "",  "updatedAt": "2026-01-15T12:00:00Z",  "wherebyMeetingId": "0123456789abcdef01234567",  "wherebyRoomName": "Exemplo sintético"}