Start Livestream

POST

/openapi/v2.0/live-stream/start

After enabling the device livestream feature, the device automatically pushes streams to the media server and returns the authentication info of the corresponding livestream provider. You need to integrate the provider's SDK (e.g., Volcano Engine, Agora, SRS, etc.) and call its API with the authentication info to pull the livestream.

Note: FlightHub 2 dynamically selects livestream providers as mutual backups. Reliance on this API requires integrating multiple providers' SDKs; otherwise, you may encounter unsupported cases.

Tips:

camera_index can be obtained from data.list.drone.camera_list in the Get Device List Under Organization interface.

After 5 minutes with no viewers pulling the stream, livestream push will stop.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "sn": "8UUDMAQ00A0133",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "quality_type": "adaptive"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/live-stream/start' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: e7b81eec-f182-473a-9368-9e220e46f9d9' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'Content-Type: application/json' \
--data '{
    "sn": "8UUDMAQ00A0133",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "quality_type": "adaptive"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "",
    "data": {
        "expire_ts": 1779446430,
        "url": "app_id=660cc8f53dea1701647170e3&expire_time=1779446430&room_id=8UUDMAQ00A0133_165-0-7&token=001660cc8f53dea1701647170e3VgCNxCECPikQap4yEGoWADhVVURNQVEwMEEwMTMzXzE2NS0wLTcoAHdpbmRvd18xOTk4MjM1ODE2MjM4NjYxNjMyXzE3Nzk0NDQwMjg3NTcBAAQAnjIQaiAAOfrsNmHL07%2BFfmceyztMZZ7bvOf%2FtBvPsV6r7lyVoVQ%3D&user_id=window_1998235816238661632_1779444028757",
        "url_type": "volc"
    }
}

🟠400

🟠401

🟠403

🔴500

Modified at 2026-05-26 14:32:15

Get Device Livestream Share List

Flight Task Tutorial