動画からアニメーション画像への変換とは - Object Storage Service

動画からアニメーション画像への変換は、動画を GIF または WebP 形式のアニメーション画像に変換するメディア処理技術です。

機能紹介

動画からアニメーション画像への変換は、動画ファイルを GIF や WebP などのアニメーション画像形式に変換し、ウェブサイトやソーシャルメディアプラットフォームでの便利な共有や埋め込みを容易にします。

zhuandongtu

シナリオ

ソーシャルメディアでの共有: アニメーション画像を使用すると、ユーザーはソーシャルプラットフォームでビデオクリップを簡単に共有して、感情、ユーモラスな瞬間、または重要な情報を表現できます。
オンラインステッカー: 動画をアニメーション画像に変換して、楽しくユーモラスなステッカーを作成し、オンラインコミュニケーションの楽しさを高めることができます。
チュートリアルとデモンストレーション: 教育やデモンストレーションでは、アニメーション画像を使用してソフトウェアの操作やステップバイステップのガイドを紹介し、視聴者が複雑な概念や手順をすばやく理解できるようにします。
ライブストリーミングとイベントの再生: 競技、イベント、またはライブブロードキャスト中にアニメーション画像を使用してハイライトをすばやく切り取って共有し、視聴者のエンゲージメントを高めることができます。

使用方法

前提条件

Intelligent Media Management (IMM) を有効化していること。
OSS でバケットを作成し、処理するファイルをバケットにアップロードしていること。
IMM プロジェクトを作成し、アタッチしていること。OSS コンソールまたは API の呼び出しによってアタッチできます。IMM プロジェクトは、バケットと同じリージョンにある必要があります。
ユーザーに必要な権限を付与していること。

動画からアニメーション画像への変換

OSS SDK for Java、Python、または Go を使用して、動画をアニメーション画像に変換できます。

Java

OSS SDK for Java V3.17.4 以降が必要です。

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 を、バケットが配置されているリージョンのエンドポイントに設定します。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // エンドポイントに対応するリージョンを指定します。例: cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス資格情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。
        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

OSS SDK for Python V2.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())
    # バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
    endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
    # バケットが配置されている Alibaba Cloud リージョンの ID を指定します。例: cn-hangzhou。
    region = 'cn-hangzhou'

    # バケットの名前を指定します。例: 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_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

OSS SDK for Go V3.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 インスタンスを作成します。
    // バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。実際の エンドポイントを指定してください。
    // バケットが配置されている Alibaba Cloud リージョンの 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)
    }
    // バケットの名前を指定します。例: 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 でエンコードされます。
    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	いいえ	アニメーション画像の幅。単位: ピクセル。有効な値: 32～4096。デフォルトでは、アニメーション画像の幅は動画の幅と同じです。
h	int	いいえ	アニメーション画像の高さ。単位: ピクセル。有効な値: 32～4096。デフォルトでは、アニメーション画像の高さは動画の高さと同じです。
scaletype	string	いいえ	サイズ変更モード。有効な値: crop: フレームのサイズを変更してトリミングします。 stretch (デフォルト): フレームを空間全体に引き伸ばします。 fill: フレームのサイズを変更し、黒い罫線を保持します。 fit: フレームを比例的にサイズ変更し、黒い罫線を削除します。

説明

動画をアニメーション画像に変換する場合、sys/saveas および notify パラメーターが使用されます。詳細については、「名前を付けて保存」および「メッセージ通知」をご参照ください。

課金

動画からアニメーション画像への変換プロセス中、IMM サービスが呼び出されるため、OSS と IMM の両側で次の課金アイテムが生成されます:

OSS 側: 詳細な料金については、「OSS 料金」をご参照ください。

API	課金アイテム	説明
GetObject	GET リクエスト	成功したリクエストの数に基づいてリクエスト料金が課金されます。
	インターネット経由のアウトバウンドトラフィック	oss-cn-hangzhou.aliyuncs.com などのパブリックエンドポイント、または oss-accelerate.aliyuncs.com などのアクセラレーションエンドポイントを使用して GetObject 操作を呼び出す場合、データサイズに基づいてインターネット経由のアウトバウンドトラフィックの料金が課金されます。
	IA オブジェクトのデータ取得	IA オブジェクトが取得された場合、取得された IA データのサイズに基づいて IA データ取得料金が課金されます。
	アーカイブダイレクト読み取り取得容量	リアルタイムアクセスが有効になっているバケット内のアーカイブオブジェクトが取得された場合、取得されたアーカイブオブジェクトのサイズに基づいてアーカイブデータ取得料金が課金されます。
	転送アクセラレーション	転送アクセラレーションを有効にし、アクセラレーションエンドポイントを使用してバケットにアクセスする場合、データサイズに基づいて転送アクセラレーション料金が課金されます。
PutObject	PUT リクエスト	成功したリクエストの数に基づいてリクエスト料金が課金されます。
PutObject	ストレージ料金	オブジェクトのストレージタイプ、サイズ、およびストレージ期間に基づいてストレージ料金が課金されます。
HeadObject	GET リクエスト	成功したリクエストの数に基づいてリクエスト料金が課金されます。

IMM 側: 詳細な料金については、「IMM 課金アイテム」をご参照ください。

重要

2025 年 7 月 28 日 11:00 (UTC + 08:00) から、IMM の動画からアニメーション画像への変換サービスは無料モデルから有料モデルにアップグレードされます。特定の課金アイテムは MediaAnimation です。詳細については、「IMM 課金調整のお知らせ」をご参照ください。

API	課金アイテム	説明
CreateMediaConvertTask	MediaAnimation	動画からアニメーション画像への変換料金は、出力されるアニメーション画像のフレーム数に基づいて計算されます

使用上の注意

動画からアニメーション画像への変換は、非同期処理 (x-oss-async-process) のみをサポートします。
匿名アクセスは拒否されます。

Object Storage Service:動画からアニメーション画像への変換