什麼是視頻轉動圖 - Object Storage Service

您可以通過視頻轉動圖功能，將視頻轉換為GIF、WebP等格式的動圖。

功能簡介

視頻轉動圖是將視頻檔案轉換為生動影像格式，如GIF或WebP，從而實現其在網頁和社交媒體上的便捷分享與嵌入。

zhuandongtu

使用情境

社交媒體分享：通過動圖，使用者能夠在社交平台上便捷地分享視頻片段，以表達情感、幽默時刻或重要訊息。
線上表情包：將視頻轉換為動圖可用於製作趣味或搞笑的表情包，從而增強線上交流的趣味性。
教程和示範：在教學與示範中，動態圖片可用於展示軟體操作或步驟引導，以協助觀眾快速理解複雜的概念和流程。
直播和賽事回放：在比賽、活動或直播過程中，可以利用動圖快速剪輯精彩瞬間，以便分享給觀眾，從而增強活動的參與感。

如何使用

前提條件

已開通Intelligent Media Management（IMM）服務。
在OSS中建立儲存空間（Bucket），上傳需要處理的檔案至Bucket中。
已建立並綁定 IMM Project，您可以通過OSS控制台綁定或調用API綁定，IMM Project需要跟Bucket在同一地區下。
已授權使用者對應操作的許可權。

視頻轉動圖

僅支援使用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";
        // 填寫Endpoint對應的Region資訊，例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 指定Bucket名稱。
        String bucketName = "examplebucket";
        // 指定處理後GIF動圖檔案名稱。
        String targetKey = "dest.gif";
        // 指定原視頻檔案名稱。
        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/animation,f_gif,w_100,h_100,inter_1000");
            // 構建非同步處理指示。
            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/notify,topic_QXVkaW9Db252ZXJ0", 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():
    # 從環境變數中擷取臨時訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
    # 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
    # 指定阿里雲通用Region ID，例如cn-hangzhou。
    region = 'cn-hangzhou'

    # 指定Bucket名稱，例如examplebucket。
    bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)

    # 指定原視頻檔案名稱。
    source_key = 'src.mp4'

    # 指定處理後GIF動圖檔案名稱。
    target_key = 'example.gif'

    # 定義視頻轉GIF動圖的參數，包括GIF寬度、高度、間隔幀數等。
    animation_style = 'video/animation,f_gif,w_100,h_100,inter_1000'

    # 構建處理指示，包括儲存路徑和Base64編碼的Bucket名稱和目標檔案名稱。
    bucket_name_encoded = base64.urlsafe_b64encode('examplebucket'.encode()).decode().rstrip('=')
    target_key_encoded = base64.urlsafe_b64encode(target_key.encode()).decode().rstrip('=')
    process = f"{animation_style}|sys/saveas,b_{bucket_name_encoded},o_{target_key_encoded}/notify,topic_QXVkaW9Db252ZXJ0"

    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"
    "github.com/aliyun/aliyun-oss-go-sdk/oss"
    "log"
)

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請按實際情況填寫。
    // yourRegion指定阿里雲通用Region ID，例如cn-hangzhou。
    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)
    if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
    }

    // 指定原視頻檔案名稱。
    sourceKey := "src.mp4"
    // 指定處理後GIF動圖檔案名稱。
    targetKey := "destexample.gif"

    // 定義視頻轉GIF動圖的參數，包括GIF寬度、高度、間隔幀數等。
    animationStyle := "video/animation,f_gif,w_100,h_100,inter_1000"

    // 構建處理指示，包括儲存路徑和Base64編碼的Bucket名稱和目標檔案名稱。
    bucketNameEncoded := base64.URLEncoding.EncodeToString([]byte(bucketName))
    targetKeyEncoded := base64.URLEncoding.EncodeToString([]byte(targetKey))
    process := fmt.Sprintf("%s|sys/saveas,b_%v,o_%v/notify,topic_QXVkaW9Db252ZXJ0", animationStyle, bucketNameEncoded, targetKeyEncoded)

    // 執行非同步處理任務。
    result, err := bucket.AsyncProcessObject(sourceKey, process)
    if err != nil {
    log.Fatalf("Failed to async process object: %s", err)
    }

    fmt.Printf("EventId: %s\n", result.EventId)
    fmt.Printf("RequestId: %s\n", result.RequestId)
    fmt.Printf("TaskId: %s\n", result.TaskId)
}

參數說明

操作名稱：video/animation

具體參數如下表所示。

參數	類型	是否必須	描述
ss	int	否	視頻轉動圖的起始時間，單位為毫秒。取值： 0（預設值）：從起始位置開始。大於0：從第ss毫秒開始。
f	string	是	動圖輸出格式，取值： gif webp
num	int	否	動圖幀數量，預設為不限制數量（抽幀到視頻結束）。重要當視頻長度不足時，實際抽幀數量會小於設定的參數值。
inter	int	否	動圖抽幀間隔，單位為毫秒，預設抽取所有視訊框架。說明當該參數小於源視訊框架間隔（幀率倒數）時，會按源視訊框架間隔進行抽幀。
fps	float	否	動圖幀率，預設為inter倒數。取值範圍為[0, 240]。說明該參數控制動圖的播放速度，當為預設值時與源視頻播放速度一致。比預設值大將產生加速效果，比預設值小將產生減速效果。
w	int	否	輸出動圖的寬度，單位為px，取值範圍為[32,4096]，預設與源視頻寬度相同。
h	int	否	輸出動圖的高度，單位為px，取值範圍為[32,4096]，預設與源視頻高度相同。
scaletype	string	否	縮放方式。取值： crop：縮放並裁剪。 stretch（預設值）：展開以填滿。 fill：縮放並保留黑邊。 fit：縮放並不保留黑邊，等比縮放。

說明

視頻轉動圖時會用到sys/saveas和notify參數，詳細參數說明請參見另存新檔和訊息通知。

計費說明

在視頻轉動圖過程中，由於調用了 IMM 服務， OSS 和 IMM 兩側會產生以下計費項目：

OSS 側：詳細定價請參見OSS產品定價

API	計費項目	說明
GetObject	GET 類型請求	根據成功的請求次數計算請求費用。
	外網流出流量費用	如果是通過外網Endpoint（樣本值oss-cn-hangzhou.aliyuncs.com）或者傳輸加速Endpoint（樣本值oss-accelerate.aliyuncs.com）調用GetObject介面時，會產生外網流出流量費用，根據資料容量大小計費。
	低頻訪問資料取回容量	如果取回的資料是低頻訪問資料，會產生低頻訪問資料取回容量的費用，按資料取回量計費。
	歸檔直讀資料取回容量	如果讀取的是歸檔的Object且Bucket開啟了歸檔直讀，會產生歸檔直讀資料取回容量費用，根據取回的資料容量大小計費。
	傳輸加速	如果開啟了傳輸加速功能且使用傳輸加速網域名稱訪問您的Bucket會產生傳輸加速費用，根據資料容量大小計費。
PutObject	PUT類型請求	根據成功的請求次數計算請求費用。
PutObject	儲存費用	根據Object的儲存類型、大小和時間長度收取儲存費用。
HeadObject	GET 類型請求	根據成功的請求次數計算請求費用。

IMM 側：詳細定價請參見IMM計費項目
重要
自北京時間 2025 年 7 月 28 日 11:00 起，IMM 視頻轉動圖服務將由原來的免費模式升級為計費模式，具體的計費項目為MediaAnimation，更多資訊請參見IMM計費調整公告。
API
計費項目
說明
CreateMediaConvertTask
MediaAnimation
根據輸出動圖幀數計算視頻轉動圖的費用

注意事項

視頻轉動圖僅支援非同步處理（x-oss-async-process處理方式）。
不支援匿名訪問。

Object Storage Service：視頻轉動圖