Help Center/ MetaStudio/ API Reference/ Virtual Avatar Video Production/ Virtual Avatar Video Production Management/ Querying Virtual Avatar Video Production Task Details

Updated on 2025-12-08 GMT+08:00

Online Debugging

CLI Examples

View PDF

Querying Virtual Avatar Video Production Task Details

Function

Queries virtual avatar video production task details.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

GET /v1/{project_id}/2d-digital-human-videos/{job_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
job_id	Yes	String	Task ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
show_script	No	Boolean	Whether to return the script parameter configuration. Default value: false

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token. This parameter is mandatory when token authentication is used. You can obtain the token by calling the IAM API used to obtain a user token. Value of X-Subject-Token in the response header.
Authorization	No	String	Authentication information. This parameter is mandatory for AK/SK authentication.
X-Sdk-Date	No	String	Time when the request is sent. This parameter is mandatory for AK/SK authentication. The format is YYYYMMDD'T'HHMMSS'Z'.
X-Project-Id	No	String	Project ID. This parameter is mandatory for AK/SK authentication.
X-App-UserId	No	String	Third-party user ID, which does not allow Chinese characters.

Response Parameters

Status code: 200

**Table 4** Response header parameters
Parameter	Type	Description
X-Request-Id	String	Request ID.

**Table 5** Response body parameters
Parameter	Type	Description
job_id	String	Task ID.
state	String	Task status. WAITING: waiting... PROCESSING: ongoing SUCCEED: succeeded FAILED: failed CANCELED: canceled BLOCK: frozen
job_type	String	Task type. 2D_DIGITAL_HUMAN_VIDEO: virtual avatar video production task DIGITAL_HUMAN_PHOTO_VIDEO: photo-based virtual avatar video production
start_time	String	Start time of virtual human video production.
end_time	String	End time of virtual human video production.
duration	Float	Definition: Virtual avatar video duration. Value range: 0~2147483647
output_asset_config	OutputAssetInfo object	Output asset information.
error_info	ErrorResponse object	Error message.
create_time	String	Task creation time.
lastupdate_time	String	Task update time.
script_id	String	Script ID.
video_making_type	String	Video generation mode. If this parameter is set to MODEL, model_asset_id is mandatory. If this parameter is set to PICTURE, human_image is mandatory. MODEL: Generates a video from a virtual avatar model. PICTURE: Generates a video from one photo. NOTE: This parameter has been discarded. The API for creating a photo-based virtual avatar video production task will be used.
human_image	String	Person photo, which must be encoded using Base64. NOTE: This parameter has been discarded. The API for creating a photo-based virtual avatar video production task will be used.
model_asset_id	String	Virtual avatar model asset ID, which can be queried from the asset library.
voice_config	VoiceConfig object	Voice parameter settings.
video_config	VideoConfig object	Video output configuration.
shoot_scripts	Array of ShootScriptItem objects	Video shooting scripts.
background_music_config	BackgroundMusicConfig object	Background music configuration.

**Table 6** OutputAssetInfo
Parameter	Type	Description
asset_id	String	Output video asset ID.
asset_name	String	Output video asset name.
cover_url	String	Video thumbnail URL.
preview_video_url	String	URL for downloading a preview video. The validity period of the URL is 24 hours. NOTE: Virtual avatar videos do not support preview.

**Table 7** ErrorResponse
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

**Table 8** VoiceConfig
Parameter	Type	Description
voice_asset_id	String	Definition Timbre asset ID, which can be queried from the asset library. For details about how to query voice IDs, see Querying Preset Voice IDs. Constraints N/A Range The value can contain 1 to 256 characters. Default Value N/A
speed	Integer	Definition Speaking speed. 50 indicates 0.5x speaking speed, 100 indicates normal speaking speed, and 200 indicates 2x speaking speed. The value 100 indicates the normal speaking speed of an adult, which is about 250 words per minute. Constraints N/A Value range: 50~200 Default value: 100
pitch	Integer	Definition Pitch. Constraints N/A Value range: 50~200 Default value: 100
volume	Integer	Definition Volume. Constraints N/A Value range: 90~240 Default value: 140

**Table 9** VideoConfig
Parameter	Type	Description
clip_mode	String	Definition Clipping mode of the output video. Constraints N/A Range RESIZE: video scaling CROP: video cropping Default value: RESIZE
codec	String	Definition Video encoding format and video file format. Constraints Only virtual avatar video production supports VP8 and QTRLE encoding. When QTRLE encoding is used, the number of characters for text-based control is less than 1,500, and the audio length for audio-based control is less than 5 minutes. You can use QTRLE encoding only after being whitelisted. Range H264: H.264 encoding, MP4 file output VP8: VP8 encoding, WebM file output QTRLE: QTRLE encoding, MOV file output Default Value H264 Default value: H264
bitrate	Integer	Definition Average output bitrate. Unit: kbit/s Constraints Quality is prioritized for virtual avatar video production, which may exceed the preset bitrate. Bitrate range for virtual avatar video production: [1000, 8000]. Default Value N/A Value range: 40~30000
width	Integer	Definition Video width. Unit: pixel Constraints When clip_mode is set to RESIZE, the following resolutions are supported: 1920 x 1080, 1080 x 1920, 1280 x 720, 720 x 1280, 3840 x 2160, and 2160 x 3840. 4K is available only when the virtual avatar model supports 4K. When clip_mode is set to CROP, (dx, dy) is the origin, and the width is the actual width of the reserved video. Virtual avatar livestreaming and intelligent interaction support only 1080 x 1920 and 1920 x 1080. Default Value N/A Value range: 0~3840
height	Integer	Definition Video height. Unit: pixel Constraints When clip_mode is set to RESIZE, the following resolutions are supported: 1920 x 1080, 1080 x 1920, 1280 x 720, 720 x 1280, 3840 x 2160, and 2160 x 3840. When clip_mode is set to CROP, (dx, dy) is the origin, and the height is the actual height of the reserved video. Virtual avatar livestreaming and intelligent interaction support only 1080 x 1920 and 1920 x 1080. Default Value N/A Value range: 0~3840
frame_rate	String	Definition Frame rate. Unit: FPS Constraints The virtual avatar video frame rate is fixed at 25 FPS. Default value: 25
is_subtitle_enable	Boolean	Definition Whether the output video is subtitled. Constraints Subtitles are not supported for virtual avatar livestreaming. Range true: subtitling enabled false: subtitling disabled Default value: false
subtitle_config	SubtitleConfig object	Subtitle configuration.
dx	Integer	Definition Horizontal coordinate of the pixel in the upper left corner of the cropped video. NOTE: The image layout size is based on the model resolution. For example, for a model with the resolution of 1920 x 1080, the value of dx ranges from 0 to 1920. Constraints This parameter takes effect when clip_mode is set to CROP. Default Value N/A Value range: -1920~3840
dy	Integer	Definition Vertical coordinate of the pixel in the upper left corner of the cropped video. NOTE: The image layout size is based on the model resolution. For example, for a model with the resolution of 1920 x 1080, the value of dy ranges from 0 to 1080. Constraints This parameter takes effect when clip_mode is set to CROP. Default Value N/A Value range: -1920~3840
is_enable_super_resolution	Boolean	Definition Whether super resolution is enabled for a video. Constraints This parameter is available only for virtual avatar video production. Range true: enabled false: disabled Default value: false
is_end_at_first_frame	Boolean	Definition Whether the end frame of a video is the same as the start frame. Set this parameter to true if multiple virtual avatar videos need to be seamlessly merged. Constraints This parameter is supported only for virtual avatar video production. This setting becomes invalid after an action tag is inserted during video production. Range true: enabled false: disabled Default value: false
output_external_url	String	External URL to which a video file is uploaded. NOTE: You can upload a video to an external URL only after being whitelisted.
is_vocabulary_config_enable	Boolean	Definition Whether to apply the pronunciation configuration of the current tenant. Constraints This parameter is available only for virtual avatar video production. Range true: enabled false: disabled Default value: true

**Table 10** SubtitleConfig
Parameter	Type	Description
dx	Integer	Definition Coordinates of the pixel in the lower left corner of the subtitle box. Constraints N/A Default Value N/A Value range: 0~1920
dy	Integer	Definition Coordinates of the pixel in the lower left corner of the subtitle box. Constraints N/A Default Value N/A Value range: 0~1920
h	Integer	Definition Subtitle box height. Constraints The parameter h is used to facilitate the calculation of the coordinates in the upper left corner of the subtitle box. This parameter is not used in the background. Value range: 0~1920
w	Integer	Definition Subtitle box width. Constraints The subtitle box width is fixed at 80/ %of the screen width. The parameter w is used to facilitate the calculation of the coordinates in the upper left corner of the subtitle box. This parameter is not used in the background. Value range: 0~1920
font_name	String	Definition Font. For details about the supported fonts, see Supported Fonts. Constraints N/A Range The value can contain 0 to 64 characters. Default value: HarmonyOS_Sans_SC_Black
font_size	Integer	Definition Font size. The interface value ranges from 0 to 120. The actual value range is 24 to 120. Use the actual value range. Constraints N/A Value range: 0~120 Default value: 54
font_color	String	Definition RGB color value of the subtitle font. Constraints None. Range The value has a fixed length and contains 0 to 7 characters. Default value: #FFFFFF
stroke_color	String	Definition RGB color value of the subtitle font stroke. Constraints None. Range The value has a fixed length and contains 0 to 7 characters.
stroke_thickness	Float	Definition Pixel value of the subtitle font stroke. Constraints None. Range 0-50 Value range: 0~50
opacity	Float	Definition Subtitle font opacity. 0 indicates 100/ %transparency and 1 indicates 100/ %opacity. The default value is 1. Constraints None. Range 0-1 Value range: 0~1 Default value: 1

**Table 11** ShootScriptItem
Parameter	Type	Description
sequence_no	Integer	Definition Script No. Constraints The sequence number of a script must be unique. Default Value N/A Value range: 0~2147483647
shoot_script	ShootScript object	Performance script.
subtitle_file_info	SubtitleFiles object	Subtitle file information.

**Table 12** ShootScript
Parameter	Type	Description
script_type	String	Definition Script type, that is, the control mode of video production. Constraints N/A Range TEXT: text control, that is, using TTS AUDIO: speech control Default value: TEXT
text_config	TextConfig object	Commentary configuration.
audio_duration	Float	Duration of an audio for audio-based control, in seconds. NOTE: This parameter is optional for script creation. After an audio file is uploaded, set this parameter by calling the API for script update. When script details are queried, the audio duration is returned to estimate the video duration. Value range: 0~36000
audio_drive_action_config	Array of AudioDriveActionConfig objects	Action configuration for speech control.
audio_drive_file_external_url	String	External URL for downloading the audio file for speech control. NOTE: This parameter is valid only for virtual avatar video production. You can download the audio file for speech control of the virtual avatar video from an external URL only after being whitelisted. The audio file must be stored in Huawei Cloud OBS.
background_config	Array of BackgroundConfigInfo objects	Background configuration.
layer_config	Array of LayerConfig objects	Overlay configuration. NOTE: *This parameter is mandatory when VP8 encoding is used and the resolution of the virtual avatar model differs from that of the output video.
audio_config	AudioInfo object	Audio file information.

**Table 13** TextConfig
Parameter	Type	Description
text	String	Definition Script. Two modes are supported: plain text mode and tag mode. Plain text mode, for example, "Hello, everyone, I'm a virtual streamer." Tag mode: For details about the definition of SSML tags, see SSML Definition of Text Control. Constraints The value can contain a maximum of 10,000 characters, excluding the SSML tag. Range The value contains 0 to 131,072 characters. Default Value N/A

**Table 14** AudioDriveActionConfig
Parameter	Type	Description
action_tag	String	Action tag.
action_name	String	Action name.
action_start_time	Float	Action start time. Value range: 0~2592000

**Table 15** BackgroundConfigInfo
Parameter	Type	Description
background_type	String	Definition Background type. Constraints N/A Range IMAGE: image background, which is used as the virtual avatar video background COLOR: solid color background. The RGB value of the specified color is used as the virtual avatar video background. Default Value N/A
background_config	String	Definition Background file URL. Constraints External URLs are allowed only for livestreaming. For other services, obtain a URL from the asset library. This parameter is mandatory when background_type is set to IMAGE. Range The value contains 1 to 2,048 characters. Default Value N/A
background_color_config	String	Definition RGB color value of a solid color background. Constraints This parameter is mandatory when background_type is set to COLOR. Range The value contains 0 to 16 characters. Default value: #FFFFFF
background_asset_id	String	Definition Background asset ID. NOTE: If a background image is used, enter the image asset ID. Constraints N/A Range The value can contain 0 to 64 characters. Default Value N/A
background_image_config	BackgroundImageConfig object	Background image size and position setting.

**Table 16** BackgroundImageConfig
Parameter	Type	Description
dx	Integer	Definition X axis position of the pixel in the upper left corner of the background image. The coordinate of the upper left corner of the preview area is 0x0. The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The background image must cover the entire preview area. That is, dx ≤ 0, dx + width ≥ 1920 in landscape mode, and dx + width ≥ 1080 in portrait mode. Value range: -5760~0 Default value: 0
dy	Integer	Definition Y axis position of the pixel in the upper left corner of the background image. The coordinate of the upper left corner of the preview area is 0x0. The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The background image must cover the entire preview area. That is, dy ≤ 0, dy + height ≥ 1080 in landscape mode, and dy + height ≥ 1920 in portrait mode. Value range: -5760~0 Default value: 0
width	Integer	Definition Width (in pixels) of the background image (relative to the preview area size). The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The background image must cover the entire preview area. That is, width > 1080, dx + width ≥ 1920 in landscape mode, and dx + width ≥ 1080 in portrait mode. Value range: 1~7680
height	Integer	Definition Height (in pixels) of the background image (relative to the preview area size). The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The background image must cover the entire preview area. height > 1080, dy + height ≥ 1080 in landscape mode, and dy + height ≥ 1920 in portrait mode. Value range: 1~7680

**Table 17** LayerConfig
Parameter	Type	Description
layer_type	String	Definition Layer type. Constraints N/A Range HUMAN: person layer IMAGE: image layer VIDEO: video layer TEXT: text layer Default Value N/A
asset_id	String	Definition ID of the asset overlaid on a video. You do not need to set this parameter for external assets. Constraints N/A Range The value can contain 0 to 64 characters. Default Value N/A
group_id	String	Definition Groups materials in multiple scenes. Materials with the same group_id share location information when they are applied globally. Constraints N/A Range The value can contain 0 to 64 characters. Default Value N/A
sequence_no	Integer	Definition Overlay of the paragraph currently being shown. This field is forward compatible and optional. This parameter is valid only for livestreaming. Constraints The paragraph is subject to sequence_no. Default Value N/A Value range: 0~2147483647
position	LayerPositionConfig object	Layer position configuration.
size	LayerSizeConfig object	Layer size configuration.
rotation	LayerRotationConfig object	Overlay rotation configuration.
image_config	ImageLayerConfig object	Image layer configuration.
video_config	VideoLayerConfig object	Video overlay configuration.
text_config	TextLayerConfig object	Material text layer configuration.

**Table 18** LayerPositionConfig
Parameter	Type	Description
dx	Integer	Definition X axis position of the pixel in the upper left corner of the image. The coordinate of the upper left corner of the image layout is 0x0. The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The value is the pixel value relative to the image layout. It indicates only the layout position relationship and is irrelevant to the resolution of the output image. Value range: -1920~3840 Default value: 0
dy	Integer	Definition Y axis position of the pixel in the upper left corner of the image. The coordinate of the upper left corner of the image layout is 0x0. The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The value is the pixel value relative to the image layout. It indicates only the layout position relationship and is irrelevant to the resolution of the output image. Value range: -1920~3840 Default value: 0
layer_index	Integer	Definition Overlay sequence of an image, video, or person image. NOTE: The overlay sequence is an integer starting from 1 and incremented by 1. Constraints If there are duplicate overlays, the relationship between the duplicate overlays is random. Value range: 1~100 Default value: 100

**Table 19** LayerSizeConfig
Parameter	Type	Description
width	Integer	Definition Y axis position of the pixel in the upper left corner of the image, that is, width (in pixels) of the image overlay (relative to the preview area size). The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The value is the pixel value relative to the image layout. It indicates only the layout position relationship and is irrelevant to the resolution of the output image. Value range: 1~7680
height	Integer	Definition Height (in pixels) of the image overlay (relative to the preview area size). The video resolution is 1920 x 1080 in landscape mode (16:9) and 1080 x 1920 in portrait mode (9:16). Constraints The value is the pixel value relative to the image layout. It indicates only the layout position relationship and is irrelevant to the resolution of the output image. \| Value range: 1~7680

**Table 20** LayerRotationConfig
Parameter	Type	Description
angle	Integer	Definition Rotation angle. Range 0 to 360 degrees Default Value 0 degrees Constraints The material is rotated around the center point. Video materials cannot be rotated. Value range: 0~360

**Table 21** ImageLayerConfig
Parameter	Type	Description
image_url	String	Definition Image file URL. Constraints External URLs are allowed only for livestreaming. For other services, obtain a URL from the asset library. Range The value contains 1 to 2,048 characters. Default Value N/A

**Table 22** VideoLayerConfig
Parameter	Type	Description
video_url	String	Definition Video file URL. Constraints External URLs are allowed only for livestreaming. For other services, obtain a URL from the asset library. Range The value contains 1 to 2,048 characters. Default Value N/A
video_cover_url	String	Definition Video thumbnail file URL. Constraints External URLs are allowed only for livestreaming. For other services, obtain a URL from the asset library. Range The value contains 1 to 2,048 characters. Default Value N/A
loop_count	Integer	Definition Number of times that a video is played cyclically. Options: 0: not played -1: played cyclically Constraints N/A Value range: -1~100 Default value: -1
video_sound	Integer	Definition The percentage used to adjust the volume of the video overlay. The value ranges from 0 to 100. The default value 0 indicates the audio is muted. Constraints N/A Value range: 0~100
is_play_the_entire_video	Boolean	Definition Whether to play the entire video. true indicates that the entire video is played. false indicates that the video stops playing when the inserted scene text or audio ends. Options: The default value is false. Constraints N/A

**Table 23** TextLayerConfig
Parameter	Type	Description
text_context	String	Definition Text of the text layer. The content must be encoded using Base64. For example, if you want to add the text watermark "Test text watermark", set text_context to 5rWL6K+V5paH5a2X5rC05Y2w. Constraints N/A Range The value contains 0 to 1,024 characters. Default Value N/A
font_name	String	Font. For details about the supported fonts, see Supported Fonts. Constraints N/A Range The value can contain 0 to 64 characters. Default value: HarmonyOS_Sans_SC_Black
font_size	Integer	Definition Font size (in pixels). The interface value ranges from 0 to 120. The actual value range is 4 to 120. Use the actual value range. Constraints N/A Value range: 0~120 Default value: 16
font_color	String	Definition Font color. RGB color value. Constraints N/A Range The value contains 0 to 16 characters. Default value: #FFFFFF

**Table 24** AudioInfo
Parameter	Type	Description
audio_id	Integer	Definition: Audio ID. NOTE: How to obtain: When the virtual avatar speaks as instructed by input audios, audio_id is returned when you query script details or update a script. Constraints: N/A Default value: N/A Value range: 0~10000

**Table 25** SubtitleFiles
Parameter	Type	Description
text_subtitle_file	SubtitleFileInfo object
audio_subtitle_file	SubtitleFileInfo object

**Table 26** SubtitleFileInfo
Parameter	Type	Description
subtitle_file_download_url	String	URL for downloading subtitle files.
subtitle_file_upload_url	String	URL for uploading subtitle files.
subtitle_file_state	String	Status of subtitle file generation. GENERATING: the subtitle file being generated GENERATE_SUCCEED: subtitle file generated **GENERATE_FAILED: subtitle file generation failed
job_id	String	ID of the subtitle file generation task.

**Table 27** BackgroundMusicConfig
Parameter	Type	Description
music_asset_id	String	Definition Music asset ID. Constraints N/A Range The value contains 0 to 64 characters. Default Value N/A
volume	Integer	Definition Music volume. For example, 100 indicates that the volume is 100%, and 50 indicates that the volume is 50%. Constraints N/A Value range: 0~100 Default value: 100

Status code: 400

**Table 28** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 401

**Table 29** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 404

**Table 30** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 500

**Table 31** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Example Requests

GET https://{endpoint}/v1/0d697589d98091f12f92c0073501cd79/2d-digital-human-videos/26f06524-4f75-4b3a-a853-b649a21aaf66

Example Responses

Status code: 200

Returned when the request succeeded.

{
  "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66",
  "state" : "SUCCESS",
  "start_time" : "2022-01-18T16:29:36Z",
  "end_time" : "2022-01-18T16:30:36Z",
  "duration" : 60,
  "output_asset_config" : {
    "asset_id" : "942e65a5fd219a2e01fb08d881cfadb9",
    "asset_name" : "One Day",
    "cover_url" : "https://{endpoint}/0d697589d98091f12f92c0073501cd79/942e65a5fd219a2e01fb08d881cfadb9/20d367508e62d3d4ad608cedbe81bd35.png?AccessKeyId=XCQKTA8IWQPCAUQS4SDA&Expires=1671241457&Signature=zVGMVbI5ji9rr8epD1Cir5OGIRk%3D"
  },
  "error_info" : null,
  "create_time" : "2022-11-30T06:59:56Z",
  "lastupdate_time" : "2022-11-30T07:00:09Z",
  "script_id" : "4b5b6effcf3b4c72a0baccb265111765",
  "model_asset_id" : "cda7e9a469ee9cf3ffc1ad62794a12ff",
  "voice_config" : {
    "voice_asset_id" : "f5e6a13eab4443fa85421191ad061780",
    "speed" : 100,
    "pitch" : 100,
    "volume" : 140
  },
  "video_config" : {
    "codec" : "H264",
    "bitrate" : 5000,
    "width" : 720,
    "height" : 1280,
    "frame_rate" : 30
  },
  "shoot_scripts" : [ {
    "sequence_no" : 0,
    "shoot_script" : {
      "text_config" : {
        "text" : "Hello, everyone. I'm Yunling."
      },
      "background_config" : [ {
        "background_type" : "IMAGE",
        "background_config" : "https://{endpoint}/0d697589d98091f12f92c0073501cd79/c7885ffdfb347337a890208ca7fd07e3/34534f0262813a6838bdcfb8bc949af6.jpg?AccessKeyId=WTEZCVDFUF3XHXCTPIJ8&Expires=1686901332&Signature=2E7Y7joo2NopBsU8u3iDnf2P9p8%3D"
      } ],
      "layer_config" : [ {
        "layer_type" : "HUMAN",
        "position" : {
          "dx" : 656,
          "dy" : 0,
          "layer_index" : 1
        },
        "size" : {
          "width" : 607,
          "height" : 1080
        }
      } ],
      "script_type" : "TEXT"
    }
  } ]
}

Status code: 400

Parameters error, including the error code and its description.

{
  "error_code" : "MSS.00000003",
  "error_msg" : "Invalid parameter"
}

Status code: 401

Authentication is not performed or fails.

{
  "error_code" : "MSS.00000001",
  "error_msg" : "Unauthorized"
}

Status code: 404

No content.

{
  "error_code" : "MSS.00000002",
  "error_msg" : "Not Found"
}

Status code: 500

Internal service error.

{
  "error_code" : "MSS.00000004",
  "error_msg" : "Internal Error"
}

Status Codes

Status Code	Description
200	Returned when the request succeeded.
400	Parameters error, including the error code and its description.
401	Authentication is not performed or fails.
404	No content.
500	Internal service error.