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
1
curl --location --request POST 'https://api.uiza.sh/v1/live_entities' \
2
--header 'Authorization: uap-c1ffbff4db954ddcb050c6af0b43ba56-41193b64' \
3
--data-raw '{
4
"name": "Test event with encoding",
5
"region": "in-bangalore-1",
6
"description": "Event for Test",
7
"encode": false,
8
"relay": [
9
{
10
"url": "rtmp://youtu.be/live",
11
"key": "Abco1",
12
"name": "Youtube 1"
13
}
14
]
15
}'
Copied!
[Live entity with encoding] Sample Request
1
curl --location --request POST 'https://api.uiza.sh/v1/live_entities' \
2
--header 'Authorization: uap-c1ffbff4db954ddcb050c6af0b43ba56-41193b64' \
3
--data-raw '{
4
"name": "Test event with encoding",
5
"region": "in-bangalore-1",
6
"description": "Event for Test",
7
"encode": true,
8
"preset_id": "9432fa62-5988-11ea-883b-028fc5698662",
9
"relay": [
10
{
11
"url": "rtmp://youtu.be/live",
12
"key": "Abco1"
13
}
14
]
15
}'
Copied!
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)
Copy link