AIOZ Stream API
Livestream Multicast

Livestream Multicast

Currently, AIOZ Stream supports multicast streaming to multiple platforms using RTMP. This feature allows you to send a single stream to multiple destinations, such as YouTube, Facebook, and Twitch, simultaneously.

This is particularly useful for content creators who want to reach a wider audience without the need for multiple encoders or separate streams.

Add or update multicast rtmp

Add multiple URLs to the list. The service will multicast your stream to all of them.

This endpoint lets you set multicast URLs for a new live stream or modify them for an existing one.

POSThttps://api.aiozstream.network/api/live_streams/multicast/:stream_key

Parameters

stream_key* The live stream key

Headers

Authorization Bearer your_access_token_here
stream-public-key your_public_key_here
stream-secret-key your_secret_key_here

Body

multicast_urls* Array of Urls to forward the stream to

Response

200: OK
{
    "status": "success",
    "data": {
        "id": "7ce757f8-b67b-46e6-8d1a-84b7a670601b",
        "live_stream_key_id": "f728df2f-ada5-4f1f-bb5e-cb896feffa30",
        "stream_key": "0e34d9db-9893-4344-a727-336566cde5e6",
        "user_id": "54f4b3da-988a-4e5a-9e99-9300b8cf482b",
        "live_stream_multicast_urls": [
            "rtmp://a.rtmp.youtube.com/live2/abcd-abcd-abcd-abcd"
        ]
    }
}
curl --location --request POST 'https://api.aiozstream.network/api/live_streams/multicast/stream_key' 
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>' 
--header 'Content-Type: application/json' 
--data-raw '{ "multicast_urls": [ "rtmp://a.rtmp.youtube.com/live2/abcd-abcd-abcd-abcd" ] }'

Get multicast urls with stream key

This endpoint allows you to get the multicast urls of a live streaming.

GEThttps://api.aiozstream.network/api/live_streams/multicast/:stream_key

Parameters

stream_key* The live streaming key

Headers

Authorization Bearer your_access_token_here
stream-public-key your_public_key_here
stream-secret-key your_secret_key_here

Response

200: OK
{
    "status": "success",
    "data": {
        "id": "7ce757f8-b67b-46e6-8d1a-84b7a670601b",
        "live_stream_key_id": "f728df2f-ada5-4f1f-bb5e-cb896feffa30",
        "stream_key": "0e34d9db-9893-4344-a727-336566cde5e6",
        "user_id": "54f4b3da-988a-4e5a-9e99-9300b8cf482b",
        "live_stream_multicast_urls": [
            "rtmp://a.rtmp.youtube.com/live2/abcd-abcd-abcd-abcd"
        ]
    }
}
curl --location --request GET 'https://api.aiozstream.network/api/live_streams/multicast/stream_key' \
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>'

Delete multicast streaming

This endpoint allows you to delete the multicast urls of a live streaming.

DELETEhttps://api.aiozstream.network/api/live_streams/multicast/:stream_key

Parameters

stream_key* The streaming key

Headers

Authorization Bearer your_access_token_here
stream-public-key your_public_key_here
stream-secret-key your_secret_key_here

Body

Response

200: OK
{
    "status": "success",
    "message": "success"
}
curl --location --request DELETE 'https://api.aiozstream.network/api/live_streams/multicast/stream_key' \
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>'