Release Notes and Announcements

Release Notes

Announcements

Product Introduction

Overview

Features

Use Cases

Strengths

Concepts

Regions and Access Endpoints

Specifications and Limits

Service Regions and Service Providers

Billing

Billing Overview

Billing Method

Billable Items

Free Tier

Billing Examples

Viewing and Downloading Bill

Payment Overdue

FAQs

Getting Started

Console

Getting Started with COSBrowser

User Guide

Creating Request

Bucket

Object

Data Management

Batch Operation

Global Acceleration

Monitoring and Alarms

Operations Center

Data Processing

Content Moderation

Smart Toolbox

Data Processing Workflow

Application Integration

User Tools

Tool Overview

Installation and Configuration of Environment

COSBrowser

COSCLI (Beta)

COSCMD

COS Migration

FTP Server

Hadoop

COSDistCp

HDFS TO COS

GooseFS-Lite

Online Tools

Diagnostic Tool

Use Cases

Overview

Access Control and Permission Management

Performance Optimization

Accessing COS with AWS S3 SDK

Data Disaster Recovery and Backup

Domain Name Management Practice

Image Processing

Audio/Video Practices

Workflow

Direct Data Upload

Content Moderation

Data Security

Data Verification

Big Data Practice

COS Cost Optimization Solutions

Using COS in the Third-party Applications

Migration Guide

Migrating Local Data to COS

Migrating Data from Third-Party Cloud Storage Service to COS

Migrating Data from URL to COS

Migrating Data Within COS

Migrating Data Between HDFS and COS

Data Lake Storage

Cloud Native Datalake Storage

Metadata Accelerator

GooseFS

Data Processing

Data Processing Overview

Image Processing

Media Processing

Content Moderation

File Processing Service

File Preview

Troubleshooting

Obtaining RequestId

Slow Upload over Public Network

403 Error for COS Access

Resource Access Error

POST Object Common Exceptions

API Documentation

Introduction

Common Request Headers

Common Response Headers

Error Codes

Request Signature

Action List

Service APIs

Bucket APIs

Object APIs

Batch Operation APIs

Data Processing APIs

Job and Workflow

Content Moderation APIs

Cloud Antivirus API

SDK Documentation

SDK Overview

Preparations

Android SDK

C SDK

C++ SDK

.NET(C#) SDK

Flutter SDK

Go SDK

iOS SDK

Java SDK

JavaScript SDK

Node.js SDK

PHP SDK

Python SDK

React Native SDK

Mini Program SDK

Error Codes

Harmony SDK

Endpoint SDK Quality Optimization

Security and Compliance

Data Disaster Recovery

Data Security

Cloud Access Management

FAQs

GetPrivateM3U8

PDF

Focus Mode

Font Size

Last updated: 2026-01-12 18:24:16

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
﻿

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

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

tencent cloud

Cloud Object Storage

GetPrivateM3U8

Feature Overview

Authorization Guide

Service Activation

Use Limits

Fee Description

Request

Request Sample

Request Parameters

Request Header

Request Body

Response

Response Header

Response Body

Error Codes

Practical Example

Request

Response

Help and Support