---
title: "Create Stream Converter"
method: POST
path: "/openapi/v2.0/live-stream/converter"
tags: ["Livestream/Livestream Sharing & Forwarding/Bypass Streaming", "Livestream/Bypass Streaming (Private Cloud Only)"]
---

# Create Stream Converter

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

## Request

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

Create a stream converter. Calling this interface creates and stores a stream converter on FlightHub 2. You can call `Get Stream Converter List` to obtain created converters, then call `Enable/Disable Stream Converter` to turn on stream forwarding.
:::tip[]
Up to 20 stream converters can be created.
:::

## Headers

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

## Request body

- object
  - `converter_name` string, required: Name of the running converter; this name must be unique, and the sn/camera_index/rtmp_url parameters must not be identical to any existing active converter
  - `sn` string, required: SN of the stream source device, such as Dock SN or Aircraft SN
  - `camera_index` string, required: Camera index. This parameter can be obtained from data.list.drone.camera_list.camera_index in the device list
  - `schema` 'rtmp' | 'rtsp', required: Parameters
  - `schema_option` union, required: Parameter Options
    - SchemaOptionRmtp
      - `url` string: When schema is rtmp, url (push address) is required
    - SchemaOptionGb28181
      - `server_ip` string: Required when schema is gb28181
      - `server_port` string: Required when schema is gb28181
      - `device_password` string: Required when schema is gb28181
      - `local_port` string: Required when schema is gb28181
      - `device_id` string: Required when schema is gb28181
      - `local_channel` string: Required when schema is gb28181

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Notification
  - `data` object, required: Business Data
    - `converter_id` string, required: Converter ID, unique identifier of the converter

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