tencent cloud

GetPrivateM3U8
Download PDF
Last updated: 2025-09-08 17:59:39
GetPrivateM3U8
Last updated: 2025-09-08 17:59:39
Download PDF

Feature Overview

GetPrivateM3U8 API is used to obtain download authorization for private M3U8 TS resources. (This method forwards requests from Cloud Object Storage to Cloud Infinite).

Authorization Guide

When used with a sub-account, the ci:GetPrivateM3U8 permission must be granted. For details, please refer to Cloud Infinite.

Service Activation

Using this feature requires enabling Cloud Infinite in advance and binding a bucket.
Using this feature requires enabling the media processing service in advance via console or API. For details, see Enable Media Processing Service.

Use Limits

When using this API, please first confirm the relevant restrictions. For details, see Specifications and Limits.

Fee Description

This API is a paid service. The incurred fees will be collected by Cloud Infinite. For detailed billing information, see Media Processing Fees.

Request

Request Sample

GET /<ObjectKey>?ci-process=pm3u8&expires=3600 HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Description
Authorization: A request header that carries authentication information to verify the legitimacy of the request. The request parameters must include the signed information. For details, see the Request Signature documentation.

Request Parameters

The parameters are as described below:
Parameter
Description
Type
Required
ObjectKey
The filename in the COS bucket, where the bucket is specified by the Host. For example, in the Beijing-based "examplebucket-1250000000" bucket, under the "test" directory, the file "a.m3u8”， the Host should be filled as "examplebucket1250000000.cos.ap-beijing.myqcloud.com", and the ObjectKey should be filled as "test/a.m3u8".
String
No
ci-process
Operation type, fixed as pm3u8
String
Yes
expires
Relative validity period of the download credential for the private TS resource URL, in seconds, range [3600, 43200]
Int
Yes

Request Header

This API only uses common request headers. For details, see Common Request Headers documentation.

Request Body

This API has no request body.

Response

Response Header

This API only returns common response headers. For details, see Common Response Headers documentation.

Response Body

The response body contains m3u8 content, where the TS are downloadable URLs.

Error Codes

This request returns common error responses and error codes. For more information, see Error Codes.

Practical Example

Request

GET /for-test.pm3u8?ci-process=pm3u8&expires=3600 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: Auth String
Content-Length: 0

Response

HTTP/1.1 200 OK
Content-Type: application/x-mpegURL
Content-Length: 266005
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-ci
x-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:11
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-KEY:METHOD=AES-128,URI="http://website.com/aes.key?Ciphertext=xxxxx&KMSRegion=ap-guangzhou",IV=0x00000000000000000000000000000000
#EXTINF:11.333333,
test-00000.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=
#EXTINF:9.416667,
test-00001.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=
#EXTINF:9.375000,
test-00002.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=
#EXTINF:11.291667,
test-00003.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=
#EXTINF:3.500000,
test-00004.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=
#EXT-X-ENDLIST

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback