Help Center/ CloudDevice/ API Reference/ APIs/ Instance Management/ Instance Video Settings
Updated on 2025-10-30 GMT+08:00
View PDF
Share

Instance Video Settings

Function

This API is used to configure video settings.

Before calling this API, ensure that the tenant has purchased an instance.

This API is used to set the bit rate and output frame rate corresponding to each definition of an instance.

URI

PUT /v1/instances/video-setting

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

x-request-id

Yes

String

Unique ID of a request.

X-Auth-Token

Yes

String

Tenant-level token.
Table 2 Request body parameters

Parameter

Mandatory

Type

Description

instance_ids

Yes

Array of strings

Instance list. A single instance can contain a maximum of 32 characters, and the list can contain a maximum of 100 columns.

instance_settings

Yes

Array of InstanceSetting objects

Video setting content.
Table 3 InstanceSetting

Parameter

Mandatory

Type

Description

network_type

Yes

String

Network type, including MOBILE_NETWORK, WIFI, and WIRED. The three parameters are mandatory. There are six combinations based on the two mandatory parameters of encoding_type. For details, see the request example.

encoding_type

Yes

String

Encoding type, including H264 and H265. Both parameters are mandatory. There are six combinations based on the three mandatory parameters of network_type. For details, see the request example.

video_spec_groups

Yes

Array of VideoSpecGroup objects

Video specification group.
Table 4 VideoSpecGroup

Parameter

Mandatory

Type

Description

definition_540P

Yes

VideoSpec object

540p.

definition_720P

Yes

VideoSpec object

720p.

definition_1080P

Yes

VideoSpec object

1080p.
Table 5 VideoSpec

Parameter

Mandatory

Type

Description

code_rate

Yes

Integer

Bit rate, in kbit/s. The value ranges from 100 to 10000 and must be a multiple of 100.

fps

Yes

Integer

Frame rate, in fps. Value: 30 or 60.

Response Parameters

Status code: 200

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

0: successful.

KOOPHONE.API.0000: The tenant does not exist.

KOOPHONE.API.1000: The request parameter is incorrect.

KOOPHONE.API.1001: Insufficient instance permissions.

KPAPI.2209: No device can be assigned.

KOOPHONE.API.9999: Internal service error.

error_msg

String

Error description.

Status code: 400

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

0: successful.

KOOPHONE.API.0000: The tenant does not exist.

KOOPHONE.API.1000: The request parameter is incorrect.

KOOPHONE.API.1001: Insufficient instance permissions.

KPAPI.2209: No device can be assigned.

KOOPHONE.API.9999: Internal service error.

error_msg

String

Error description.

Status code: 500

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

0: successful.

KOOPHONE.API.0000: The tenant does not exist.

KOOPHONE.API.1000: The request parameter is incorrect.

KOOPHONE.API.1001: Insufficient instance permissions.

KPAPI.2209: No device can be assigned.

KOOPHONE.API.9999: Internal service error.

error_msg

String

Error description.

Example Requests

/v1/instances/video-setting

{
  "instance_ids" : [ "iRJEVP96" ],
  "instance_settings" : [ {
    "network_type" : "MOBILE_NETWORK",
    "encoding_type" : "H264",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  }, {
    "network_type" : "MOBILE_NETWORK",
    "encoding_type" : "H265",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  }, {
    "network_type" : "WIFI",
    "encoding_type" : "H264",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  }, {
    "network_type" : "WIFI",
    "encoding_type" : "H265",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  }, {
    "network_type" : "WIRED",
    "encoding_type" : "H264",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  }, {
    "network_type" : "WIRED",
    "encoding_type" : "H265",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 6000,
        "fps" : 30
      },
      "definition_1080P" : {
        "code_rate" : 8000,
        "fps" : 30
      }
    } ]
  } ]
}

Example Responses

Status code: 200

Normal response.

{
  "error_code" : "0",
  "error_msg" : "ok"
}

Status Codes

Status Code

Description

200

Normal response.

400

Bad Request

500

Internal Server Error

Error Codes

See Error Codes.

Parent topic: Instance Management