
Operation Description
- Make sure that you understand the billing method and price of ApsaraVideo VOD before you call this operation. You are charged for outbound traffic when you download or play videos based on URLs in ApsaraVideo VOD. For more information about billing of outbound traffic, see Billing of outbound traffic. If you have configured an accelerated domain name, see Billing of the acceleration service. If you have activated the acceleration service, you are charged acceleration fees when you upload media files to ApsaraVideo VOD. For more information, see Billing of acceleration traffic.
- Only videos whose Status is Normal can be played. For more information, see Overview .
- If video playback fails, you can call the GetMezzanineInfo operation to check whether the video source information is correct.
Quotas Info
Authorization Information
The following table shows the authorization information corresponding to this API, which can be used in the Action policy element to grant a RAM user or RAM role the permissions to call the API. Please use RAM to set up these permissions and refer to RAM documentation for more instructions.
Request Parameters
Field Name | Field Details |
---|---|
VideoIdstring | The ID of the media file. You can specify only one ID. You can use one of the following methods to obtain the ID:View Details... Example:93ab850b4f654b6e91d24d81d44****Reference Value Source: UpdateVideoInfos GetVideoList CreateUploadVideo RefreshUploadVideo ListLiveRecordVideo |
Formatsstring | The format of the media stream. Separate multiple formats with commas (,). Valid values:View Details... Example:mp4,m3u8 |
AuthTimeoutinteger<int64> | The validity period of the playback URL. Unit: seconds.View Details... Notice
The field type is Long, and the precision may be lost during serialization/deserialization. Please note that the value must not be greater than 9007199254740991. Example:1800 |
OutputTypestring | The type of the output URL. Default value: oss. Valid values:View Details... Example:cdn |
StreamTypestring | The type of the media stream. Separate multiple types with commas (,). Valid values:View Details... Example:video |
ReAuthInfostring | The CDN reauthentication configuration. The value must be a JSON string. If CDN reauthentication is enabled, you can use this parameter to specify the Example:{"uid":"12345","rand":"abckljd"} |
Definitionstring | The quality of the video stream. Separate multiple qualities with commas (,). Valid values:View Details... Example:LD |
ResultTypestring | The type of the data to return. Default value: Single. Valid values:View Details... Example:Single |
PlayConfigstring | The custom playback configuration. The value must be a JSON string. You can specify a domain name for playback. For more information, see PlayConfig .View Details... Example:{"PlayDomain":"vod.test_domain","XForwardedFor":"yqCD7Fp1uqChoVj/sl/p5Q==","PreviewTime":"20","MtsHlsUriToken":"yqCD7Fp1uqChoVjslp5Q"} |
AdditionTypestring | The URL of the masked live comment data. Value: danmu.View Details... Example:danmu |
Tracestring | The custom digital watermark.View Details... Example:test mark |
DigitalWatermarkTypestring | The type of the digital watermark. Valid values:View Details... Example:TraceMark |
Response Parameters
Field Name | Field Details |
---|---|
RequestIdstring | The ID of the request. Example:F552E596-967D-5500-842F-17E6364**** |
VideoBaseobject | The basic information about the audio or video file. |
PlayInfoListobject |
Sample Response
Change History
Change time | Change content summary | operation | |
---|---|---|---|
2024-12-09 | |||
2024-10-11 | |||
2023-10-18 | |||
2023-09-05 | |||
2021-12-23 | |||
2021-11-16 |