---
title: "Live View Quality Settings"
method: PUT
path: "/openapi/v2.0/device/stream/quality"
tags: ["Device Management"]
---

# Live View Quality Settings

`PUT /openapi/v2.0/device/stream/quality`

## Request

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

Set the live view quality, supporting auto, smooth, and ultra-high definition.
:::tip[]
- You must first call the `Acquire Control Permission` interface to obtain aircraft control permission before setting the live view quality.
- camera_index can be obtained from data.list.drone:.camera_list in the Get Device List Under Organization interface.
:::

## Headers

- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'
- `X-Project-Uuid` string, required
- `X-User-Token` string, required

## Request body

- object
  - `sn` string, required: Aircraft SN
  - `camera_index` string, required: Camera index. Can be obtained from `data.list.drone.camera_list.camera_index` in the `Get Device List Under Organization` interface
  - `quality_type` 'adaptive' | 'smooth' | 'ultra_high_definition', required: Quality level: `adaptive`; `smooth`; `ultra_high_definition`

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt

## 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)