---
title: "Start Livestream"
method: POST
path: "/openapi/v2.0/live-stream/start"
tags: ["Livestream/Livestream Push", "Livestream"]
---

# Start Livestream

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

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/live-stream/start`
- Auth: none required

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.

:::warning[]
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.
:::

:::tip[]
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.
:::

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string
- `X-Language` string

## Request body

- object
  - `sn` string, required
  - `camera_index` string, required
  - `video_expire` integer, required: Livestream push token validity; livestream will be terminated after this period
  - `quality_type` 'adaptive' | 'smooth' | 'ultra_high_definition', required: Livestream Quality

## Response `200`

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Business data, livestream push authentication info
    - `expire_ts` integer: Livestream Push Token Validity
    - `url` string: Livestream Pull URL
    - `url_type` string: Livestream Push Type

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `500`: Server Internal Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)