Sets all parameters, and configures and applies a layout for a scene of a production studio.

Usage note

If a scene-related parameter is not specified, the scene does not have the relevant configuration.

QPS limit

A single user can perform a maximum of 10 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes SetCasterSceneConfig

The operation that you want to perform. Set the value to SetCasterSceneConfig.

CasterId String Yes 80787064-1c94-4dc1-85ce-9409960a****

The ID of the production studio.

If you create a production studio through the CreateCaster interface, check the value of the CasterId parameter in the response.

If you create a production studio through the ApsaraVideo Live Console, log in to the console, then check the ID of the production studio through the following path:

Production Studios > Production Studio Management

Note The CasterId is reflected in the Name column on the Production Studio Management page.
SceneId String Yes 242b4e2c-c30f-4442-85ba-2e3e4e3d****

The ID of the scene. For more information about the scenes, see Query the scenes of production studios.

RegionId String No cn-shanghai

The ID of the region.

LayoutId String No 0c6da077-f037-49e8-8440-3be13393****

The ID of the layout. It is included in the response when you call the AddCasterLayout operation.

ComponentId.N RepeatList No [ "a2b8e671-2fe5-4642-a2ec-bf931826****", "a2b8e671-2fe5-4642-a2ec-28374657****"]

The ID of component N. Components in the scene are listed from the bottom to the top in an array.


N indicates a sequence number. Example:

CombponentId.1 indicates the ID of the first component.

ComponentId.2 indicates the ID of the second component.

Response parameters

Parameter Type Example Description
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format

    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7"

Error codes

For a list of error codes, visit the API Error Center.