Uiza Documentation
2020-07-01
Search…
⌃K

Create A Live Entity

To start live streaming, you need to create an Live Entity object. Once the request is received, Uiza will allocate resources to serve your live stream.
post
https://api.uiza.sh
/v1/live_entities
/v1/live_entities
[Live entity without encoding] Sample Request
curl --location --request POST 'https://api.uiza.sh/v1/live_entities' \
--header 'Authorization: uap-c1ffbff4db954ddcb050c6af0b43ba56-41193b64' \
--data-raw '{
"name": "Test event with encoding",
"region": "in-bangalore-1",
"description": "Event for Test",
"encode": false,
"relay": [
{
"url": "rtmp://youtu.be/live",
"key": "Abco1",
"name": "Youtube 1"
}
]
}'
[Live entity with encoding] Sample Request
curl --location --request POST 'https://api.uiza.sh/v1/live_entities' \
--header 'Authorization: uap-c1ffbff4db954ddcb050c6af0b43ba56-41193b64' \
--data-raw '{
"name": "Test event with encoding",
"region": "in-bangalore-1",
"description": "Event for Test",
"encode": true,
"preset_id": "9432fa62-5988-11ea-883b-028fc5698662",
"relay": [
{
"url": "rtmp://youtu.be/live",
"key": "Abco1"
}
]
}'
Defining your region helps Uiza allocate the resources that are closest to your streamers' locations. This will minimize the risks of network issues. While we are adding more and more regions to our network, here are the currently available regions.
in-bangalore-1 (Bangalore - India)
in-mumbai-1 (Mumbai - India)
sg-singapore-1 (Singapore - Singapore)
vn-saigon-1 (Ho Chi Minh City - Vietnam)
id-jakarta-1 (Jakarta - Indonesia)
us-oregon-1 (Oregon - USA)
aus-sydney-1 (Sydney - Australia)
ie-dublin-1 (Dublin - Ireland)