全部產品
Search

搜尋本產品

    Object Storage Service：視頻轉碼

    文件中心

    Object Storage Service：視頻轉碼

    更新時間：Dec 27, 2025

    當您需要修改視頻編碼格式、降低解析度和碼率、轉換封裝格式、調整視頻參數以適應不同需求，可以使用視頻轉碼功能。

    功能簡介

    視頻轉碼通過將已壓縮編碼的視頻碼流轉換為另一種視頻碼流，將視頻格式、封裝、解析度、幀率及碼率等參數轉換為適合不同裝置和平台播放，同時降低檔案大小以最佳化傳輸效率的過程。

    image

    應用情境

    • 多裝置相容性：為確保視頻能夠在不同裝置（如手機、平板、電腦、智能電視等）上順利播放，轉碼技術能夠將視頻轉換為符合特定裝置所支援的格式。

    • 流媒體播放：流媒體服務需要將視頻轉碼為多種格式和位元速率，以便根據使用者的網路狀況進行動態調整，從而提升觀看體驗。

    • 視頻壓縮：在確保視頻品質的前提下，通過轉碼技術降低檔案大小，以便於儲存和傳輸，尤其是在網路頻寬受限的情況下。

    • 檔案歸檔：轉碼能夠將高品質視頻轉換為更高效的格式，以便於長期儲存和管理，從而減少儲存空間的需求。

    • 適配不同解析度：為適應不同的播放裝置和網路環境，轉碼能夠對視頻進行降解析度處理，從而實現更流暢的播放體驗。

    • 格式轉換：某些不常用的格式可能不被播放器支援，因此通過轉碼可以將視頻轉換為更為常用的格式。

    如何使用

    前提條件

    視頻轉碼

    僅支援使用Java、Python、Go SDK通過非同步處理的方式完成視頻轉碼。

    Java

    要求使用3.17.4及以上版本的Java SDK。

    import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.AsyncProcessObjectRequest;
import com.aliyun.oss.model.AsyncProcessObjectResult;
import com.aliyuncs.exceptions.ClientException;

import java.util.Base64;

public class Demo {
    public static void main(String[] args) throws ClientException {
        // yourEndpoint填寫Bucket所在地區對應的Endpoint。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 指定阿里雲通用Region ID，例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 指定Bucket名稱，例如examplebucket。
        String bucketName = "examplebucket";
        // 指定處理後視頻檔案名稱。
        String targetKey = "dest.avi";
        // 指定原視頻檔案名稱。
        String sourceKey = "src.mp4";

        // 建立OSSClient執行個體。
        // 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 構建視頻處理樣式字串以及視頻轉碼處理參數。
            String style = String.format("video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1");
            // 構建非同步處理指示。
            String bucketEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(bucketName.getBytes());
            String targetEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(targetKey.getBytes());
            String process = String.format("%s|sys/saveas,b_%s,o_%s", style, bucketEncoded, targetEncoded);
            // 建立AsyncProcessObjectRequest對象。
            AsyncProcessObjectRequest request = new AsyncProcessObjectRequest(bucketName, sourceKey, process);
            // 執行非同步處理任務。
            AsyncProcessObjectResult response = ossClient.asyncProcessObject(request);
            System.out.println("EventId: " + response.getEventId());
            System.out.println("RequestId: " + response.getRequestId());
            System.out.println("TaskId: " + response.getTaskId());

        } finally {
            // 關閉OSSClient。
            ossClient.shutdown();
        }
    }
}

    Python

    要求使用Python SDK 2.18.4及以上版本。

    # -*- coding: utf-8 -*-
import base64
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider


def main():
    # 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
    # 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

    # 填寫Bucket名稱。
    bucket_name = 'examplebucket'
    # 填寫阿里雲通用Region ID，例如cn-hangzhou。
    region = 'cn-hangzhou'
    # 建立Bucket執行個體。
    bucket = oss2.Bucket(auth, endpoint, bucket_name, region=region)

    # 指定原視頻檔案名稱。
    source_key = 'src.mp4'
    # 指定處理後視頻檔案名稱。
    target_key = 'dest.avi'
    # 構建視頻處理樣式字串以及視頻轉碼處理參數。
    style = 'video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1'
    process = "{0}|sys/saveas,o_{1}".format(style,
                                            oss2.compat.to_string(base64.urlsafe_b64encode(
                                                oss2.compat.to_bytes(target_key))).replace('=', ''))

    # 調用非同步流ApsaraVideo for Media Processing介面。
    try:
        # 執行非同步處理任務。
        result = bucket.async_process_object(source_key, process)
        print(f"EventId: {result.event_id}")
        print(f"RequestId: {result.request_id}")
        print(f"TaskId: {result.task_id}")
    except Exception as e:
        print(f"Error: {e}")


if __name__ == "__main__":
    main()

    Go

    要求使用Go SDK 3.0.2及以上版本。

    package main

import (
	"encoding/base64"
	"fmt"
	"os"
	"strings"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 指定視頻所在的Bucket名稱，例如examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	// 指定處理後視頻檔案名稱。
	targetObject := "dest.avi"
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 指定原視頻檔案名稱。
	sourceObject := "src.mp4"

	// 構建視頻處理樣式字串以及視頻轉碼處理參數。
	style := "video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1"

	process := fmt.Sprintf("%s|sys/saveas,b_%v,o_%v", style, strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(bucketName)), "="), strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(targetObject)), "="))
	fmt.Printf("%#v\n", process)
	rs, err := bucket.AsyncProcessObject(sourceObject, process)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	fmt.Printf("EventId:%s\n", rs.EventId)
	fmt.Printf("RequestId:%s\n", rs.RequestId)
	fmt.Printf("TaskId:%s\n", rs.TaskId)
}

    參數說明

    操作名稱：video/convert

    具體參數如下表所示。

    參數

    類型

    是否必選

    描述

    ss

    int

    否

    起始時間，單位為毫秒。取值：

    • 0（預設值）：從起始位置開始。

    • 大於0：從第ss毫秒開始。

    t

    int

    否

    轉碼時間長度，單位為毫秒。取值：

    • 0（預設值）：持續到結束位置。

    • 大於0：持續t毫秒。

    f

    string

    是

    媒體容器類型。取值：

    • 音視頻容器：mp4、mkv、mov、asf、avi、mxf、ts、flv、webm

    • 音頻容器：mp3、aac、flac、oga、ac3、opus、amr

    vn

    int

    否

    是否禁用視頻流。取值：

    • 0（預設值）：不禁用。

    • 1：禁用，輸出檔案中將不包含視頻流。

    vcodec

    string

    否

    視頻codec（編碼格式）。取值：

    • copy（預設值）：將需要處理的視頻流直接拷貝到輸出檔案。

    • h264：h264編碼格式。

    • h265：h265編碼格式。

    • vp9：vp9編碼格式。

    fps

    float

    否

    視訊框架率。取值範圍：0~240。

    fpsopt

    int

    否

    視訊框架率選項。取值：

    • 0：始終使用目標幀率。

    • 1：源視訊框架率小於fps時使用源視訊框架率。

    • 2：源視訊框架率小於fps時返回失敗。

    pixfmt

    string

    否

    像素採樣格式，預設與源視頻一致。取值：

    • yuv420p

    • yuva420p

    • yuv420p10le

    • yuv422p

    • yuv422p10le

    • yuv444p

    • yuv444p10le

    s

    string

    否

    目標解析度。

    • 格式為w x h，即寬 x 高。

    • 寬和高的取值應為2的倍數，且取值範圍為64~4096。例如：4096x4096、64x64等。

    sopt

    int

    否

    解析度選項。取值：

    • 0：始終使用目標解析度。

    • 1：源視頻解析度小於s時使用源視頻解析度。

    • 2：源視頻解析度小於s時返回失敗。

    scaletype

    string

    否

    縮放方式。取值：

    • crop：等比縮放，縮放為延伸出指定寬高或長短邊的矩形框外的最小解析度，然後將超出的部分進行置中裁剪。

    • stretch（預設值）：固定寬高或長短邊，強制縮放，展開以填滿空白部分。

    • fill：等比縮放，縮放為指定寬高或長短邊的矩形內的最大解析度，然後使用黑色置中填充空白部分。

    • fit：等比縮放，縮放為指定寬高或長短邊的矩形內的最大解析度。

    arotate

    int

    否

    自適應解析度方向。取值：

    • 0（預設值）：關閉。

    • 1：開啟。

    g

    int

    否

    主要畫面格。取值範圍：1~100000。

    vb

    int

    否

    視頻位元速率（碼率），單位為位元/秒（bps）。取值範圍：10000~100000000。

    vbopt

    int

    否

    視頻碼率選項。取值：

    • 0：始終使用目標視頻碼率。

    • 1：源視頻碼率小於vb時使用源視頻碼率。

    • 2：源視頻碼率小於vb時返回失敗。

    crf

    float

    否

    碼率控制因子。取值範圍：0~51。

    maxrate

    int

    否

    峰值碼率，單位為位元/秒（bps）。取值範圍：10000~100000000。

    bufsize

    int

    否

    緩衝區大小，單位為位元（bits）。取值範圍：10000~200000000。

    an

    int

    否

    是否禁用音頻流。取值：

    • 0（預設值）：不禁用。

    • 1：禁用，輸出檔案中將不包含音頻流。

    acodec

    string

    否

    音頻codec（編碼格式）。取值：

    • copy（預設值）：將需要處理的音頻流直接拷貝到輸出檔案。

    • mp3：mp3編碼格式。

    • aac：aac編碼格式。

    • flac：flac編碼格式。

    • vorbis：vorbis編碼格式。

    • ac3：ac3編碼格式。

    • opus：opus編碼格式。

    • amr：amr編碼格式。

    ar

    int

    否

    音頻採樣率。取值：

    • 8000

    • 11025

    • 12000

    • 16000

    • 22050

    • 24000

    • 32000

    • 44100

    • 48000

    • 88200

    • 96000

    ac

    int

    否

    音頻聲道數。預設保持源音訊聲道數。取值範圍：1~8。

    aq

    int

    否

    音頻壓縮品質。與參數ab互斥。取值範圍：0~100。

    ab

    int

    否

    音頻位元速率（碼率）。與參數aq互斥，單位為位元/秒（bps）。取值範圍：1000~10000000。

    abopt

    int

    否

    音頻碼率選項。取值：

    • 0（預設值）：始終使用目標音頻碼率。

    • 1：源音頻碼率小於ab時使用源音頻碼率。

    • 2：源音頻碼率小於ab時返回失敗。

    sn

    int

    否

    是否禁用字幕。取值：

    • 0（預設值）：不禁用。

    • 1：禁用，輸出檔案中將不包含字幕。

    adepth

    int

    否

    音頻採樣位深，取值為16或24。

    說明

    該參數僅在acodec為flac時有效

    segment

    string

    否

    媒體切片設定，預設不進行切片。

    f

    string

    否

    媒體切片方式。取值：

    • hls

    • dash

    父節點：segment

    t

    int

    否

    切片長度，單位為毫秒。取值範圍：0~3600000。

    父節點：segment

    視頻轉碼時也會用到sys/saveas和notify參數。更多資訊，請參見另存新檔和訊息通知。

    相關API

    以上操作方式底層基於API實現，如果您的程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。關於公用要求標頭Authorization的計算方法，請參見簽名版本4（推薦）。

    將AVI格式轉換為MP4格式

    轉碼資訊

    • 轉碼前

      • 視頻格式：AVI

      • 視頻名稱：example.avi

    • 處理方式：視頻轉碼

    • 轉碼後

      • 視頻資訊

        • 視頻格式：MP4

        • 視頻名稱：outobjprefix.mp4

        • 視頻流格式：H.265

        • 視頻解析度：1920x1080

        • 視訊框架率：30 fps

        • 視頻碼率：2 Mbps

      • 音頻資訊

        • 音頻流格式：AAC

        • 音頻碼率：100 Kbps

        • 字幕流：禁用

      • 檔案儲存體路徑：oss://outbucket/outobjprefix.mp4

    處理樣本

    POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 對檔案example.avi進行視頻轉碼，轉碼輸出媒體檔案容器為MP4，視頻流格式為H.265，解析度為1920x1080，幀率為30 fps，視頻碼率為2 Mbps；音頻流格式為AAC，音頻碼率為100 Kbps；禁用字幕流；轉碼完成後將得到的檔案儲存為oss://outbucket/outobjprefix.mp4。
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

    將AVI格式轉換為TS格式

    轉碼資訊

    • 轉碼前

      • 視頻格式：AVI

      • 視頻名稱：example.avi

    • 處理方式

      • 轉碼時間長度：從輸入媒體檔案的第1000毫秒開始並持續60000毫秒進行視頻轉碼

      • 切片方式：按30秒間隔進行HLS切片

      • 轉碼完成訊息通知：發送MNS訊息

    • 轉碼後

      • 視頻資訊

        • 視頻格式：TS

        • 視頻流格式：H.264

        • 視頻碼率：1 Mbps

      • 音頻資訊

        • 音頻格式：AAC

        • 音頻碼率：100 Kbps

      • 檔案儲存體路徑

        • ts檔案：oss://outbucket/outobjprefix-%d.ts

        • m3u8檔案：oss://outbucket/outobjprefix.m3u8

    處理樣本

    POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 對檔案example.avi進行視頻轉碼。
x-oss-async-process=video/convert,ss_10000,t_60000,f_ts,vcodec_h264,vb_1000000,acodec_mp3,ab_100000/segment,f_hls,t_30000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_QXVkaW9Db252ZXJ0

    將AVI格式轉換為MP3格式

    轉碼資訊

    • 轉碼前

      • 視頻名稱：example.avi

      • 視頻格式：AVI

    • 處理方式：提取音頻並將提取的音頻進行轉碼

    • 轉碼後

      • 音頻容器：MP3

      • 音頻編碼格式：MP3

      • 音頻碼率：100 Kbps

      • 視頻流：禁用

      • 字幕流：禁用

      • 檔案儲存體路徑：音頻檔案儲存體路徑為oss://outbucket/outobjprefix.mp3，如果視頻有多路音頻，預設只處理第一路音頻。

    處理樣本

    POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 對檔案example.avi進行音頻提取並將提取的音頻進行轉碼。
x-oss-async-process=video/convert,f_mp3,acodec_mp3,ab_100000,vn_1,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

    注意事項

    • 視頻轉碼僅支援非同步處理（x-oss-async-process處理方式）。

    • 不支援匿名訪問。

    • 支援MP4、MPEG-TS、MKV、MOV、AVI、FLV、M3U8、WebM、WMV、RM、VOB等多種視頻格式。

    • video/convert 視頻轉碼是計費的， ApsaraVideo for Media Processing能力由Intelligent Media Management服務 (IMM) 進行計費，費用詳情請詳見計費項目。

    常見問題

    視頻轉碼時提示無法找到資源怎麼辦？

    視頻轉碼時出現報錯資訊“ResourceNotFound, The specified resource Attachment is not found.”錯誤，可能是未綁定Bucket。請在建立IMM專案後綁定Bucket。具體操作請參見oss資料處理使用指南。

    視頻轉碼時能否轉存到原路徑？

    不可以，視頻轉碼時輸出路徑應避免以輸入路徑為首碼，否則將導致觸發器迴圈觸發和源檔案被覆蓋等非預期行為。

    視頻轉碼是否支援設定音頻位深？

    視頻轉碼支援位深設定，通過OSS x-oss-process方式的pixfmt參數來進行設定。

    視頻轉碼如何通過返回的taskid擷取task執行結果？

    建議參考Intelligent Media Management的GetTask - 擷取任務資訊來擷取。

    視頻轉碼時OSS如何根據尾碼檢索刪除特定格式檔案？

    OSS不支援通過尾碼搜尋檔案，因為OSS是無序儲存。

    視頻轉碼已配置訊息佇列推送，但後端未能接收到訊息？

    確認主題及訂閱是否已建立。如不存在或被刪除，則需重新設定訂閱。根據當前配置的訂閱，重新發起轉碼處理。

    將視頻上傳至OSS後，可以使用指定的模板進行轉碼嗎？

    配置相應的觸發器即可實現相關功能。視頻處理的相關資料處理能力可以由使用者主動提交，也可以通過配置批處理和觸發器來自動觸發對儲存桶中存量和增量視頻的處理。任務、批處理和觸發器可以採用系統樣式或自訂樣式，具體請參見批處理和觸發器。

    轉碼後的視頻與源視頻的儲存是否會重複收費，如果轉碼後的檔案不採用與源檔案一致的檔案首碼，是否會進行替換？

    轉碼後的視頻將佔用儲存空間，產生計費。輸入和輸出設定相同路徑可能會導致迴圈的發生。