すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:フレームキャプチャ

最終更新日:May 07, 2026

フレームキャプチャ機能を使用して、要件に基づきビデオフレームをキャプチャし、特定のフォーマットに変換できます。本トピックでは、フレームキャプチャで設定可能なパラメーターについて説明します。また、フレームキャプチャの実行方法に関する例も提供します。

機能概要

フレームキャプチャとは、ビデオから特定のフレーム画像を抽出し、ビデオ内の特定の瞬間を静止画像として保存するプロセスを指します。

image

利用シーン

  • スナップショット:ビデオ内の特定の瞬間を静止画像として保存し、ポスターを作成します。

  • 分析:顔認識やオブジェクト検出などの後続の分析のためにキーフレームを抽出します。

  • サムネイル作成:ビデオ用のサムネイルまたはカバー画像を作成します。

  • 再生サマリー:ビデオから複数の重要な瞬間を選択し、簡潔なサマリーやプレビューを生成します。

  • スクリーンショットの共有と録画:ユーザーがビデオ視聴中に気に入ったフレームを保存または共有したい場合、その瞬間のビデオフレームをキャプチャできます。

使用方法

前提条件

ビデオフレームキャプチャ

OSS SDK を使用してフレームキャプチャタスクを非同期モードで実行できるのは、Java、Python、または Go のみです。

重要

ビデオフレームキャプチャの出力パスを指定する際、「.jpg」などのファイル拡張子を含めないでください。拡張子を含めた場合、最後のスナップショットのみが保存されます。拡張子を含めない場合、システムが各出力ファイル名に自動的にシーケンス番号(例:「_0_1.jpg」)を追加します。シーケンス番号をカスタマイズするには、メディア処理変数を使用して設定できます。

Java

OSS SDK for Java を使用する場合は、SDK バージョンが 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 {
        // バケットが配置されているリージョンのエンドポイントを指定します。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // リージョン ID を指定します。例:cn-hangzhou。
        String region = "cn-hangzhou";
        // 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケット名を指定します。例:examplebucket。
        String bucketName = "examplebucket";
        // 出力オブジェクトの名前を指定します。拡張子付きのファイル名を使用すると、最後のスナップショットのみが保存されます。上記の注意事項をご参照ください。
        String targetKey = "dest.png";
        // ソースビデオオブジェクトの名前を指定します。
        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/snapshots,f_jpg,w_100,h_100,scaletype_crop,inter_10000");
            // 非同期処理命令を構築します。
            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 を使用する場合は、SDK バージョンが 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'

    # キャプチャされたフレームの名前を指定します。
    target_key = 'dest.png'

    # フレームキャプチャパラメーターを指定します。
    animation_style = 'video/snapshots,f_jpg,w_100,h_100,scaletype_crop,inter_10000'

    # ストレージパス、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 を使用する場合は、SDK バージョンが 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"
    // キャプチャされたフレームの名前を指定します。
    targetKey := "dest.png"

    // フレームキャプチャパラメーターを指定します。
    animationStyle := "video/snapshots,f_jpg,w_100,h_100,scaletype_crop,inter_10000"

    // ストレージパス、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/snapshots

以下の表は、フレームキャプチャを使用する際に設定可能なパラメーターについて説明しています。

パラメーター

タイプ

必須

説明

ss

int

いいえ

フレームキャプチャを開始するビデオ内の時点。単位:ミリ秒。有効値:

  • 0(デフォルト):ビデオの開始点からフレームキャプチャを開始します。

  • 0 より大きい整数:ビデオ内の指定されたミリ秒位置からフレームキャプチャを開始します。

f

string

はい

戻り値のフォーマット。有効値:

  • jpg

  • png

m

string

いいえ

フレームキャプチャモード。デフォルトは inter です。有効値:

  • inter:固定間隔モード。inter パラメーターでキャプチャ間隔を設定し、num パラメーターでフレーム数を設定します。

  • key:キーフレームモード。ソースビデオから IDR フレームのみをキャプチャします。num パラメーターでフレーム数を設定します。このモードでは inter パラメーターは無視されます。

  • avg:平均モード。num で指定されたフレーム数を、均等な時間間隔でキャプチャします。このモードでは inter パラメーターは無視されます。

  • dhash:dhash モード。固定間隔でフレームをキャプチャし、指定されたしきい値を超える最も大きな変化を持つフレームを選択します。inter パラメーターでキャプチャ間隔を設定し、num でフレーム数を設定し、thr でしきい値を設定します。

thr

int

いいえ

dhash モードでのフレームキャプチャのしきい値。値が大きいほど、キャプチャされるフレーム数は少なくなります。値は 0~100 の整数である必要があります。デフォルトは 0 です。

説明

このパラメーターは、mdhash に設定されている場合にのみ有効です。

dhash モードはこのしきい値に敏感です。このパラメーターを 25 以下に設定し、具体的なユースケースに応じて調整することを推奨します。

num

int

いいえ

キャプチャするフレーム数。0(デフォルト)を指定すると、フレーム数に制限はありません。デフォルト値の動作はフレームキャプチャモードによって異なります:

  • 固定間隔モード:ビデオの終了までフレームをキャプチャします。

  • キーフレームモード:ビデオの終了までフレームをキャプチャします。

  • 平均モード:このパラメーターを 0 に設定することはできません。

  • dhash モード:thr しきい値を超えるコンテンツの変化を持つすべてのフレームをキャプチャします。

重要

ビデオの持続時間や他のフレームキャプチャパラメーターにより、実際にキャプチャされたフレーム数が指定値より少なくなる可能性があります。

inter

int

いいえ

フレームキャプチャ間の間隔(ミリ秒)。0(デフォルト)を指定すると、すべてのビデオフレームをキャプチャします。

説明

このパラメーターの値がビデオのフレーム間隔(フレームレートの逆数)より小さい場合、ビデオのフレーム間隔に基づいてフレームがキャプチャされます。

w

int

いいえ

キャプチャされたフレームの幅。単位:ピクセル。有効値:32~4096。デフォルトでは、フレームの幅はビデオの幅と等しくなります。

h

int

いいえ

キャプチャされたフレームの高さ。単位:ピクセル。有効値:32~4096。デフォルトでは、フレームの高さはビデオの高さと等しくなります。

pw

int

いいえ

キャプチャされたフレームの幅がビデオの幅に対して占める割合(%)。有効値:(0, 200]。デフォルト値:100。

説明

wpw の両方を指定した場合、システムは pw を無視します。

ph

int

いいえ

キャプチャされたフレームの高さがビデオの高さに対して占める割合(%)。有効値:(0, 200]。デフォルト値:100。

説明

hph の両方を指定した場合、システムは ph を無視します。

scaletype

string

いいえ

サイズ変更モード。有効値:

  • crop:フレームをサイズ変更および切り取ります。

  • stretch(デフォルト):フレームをストレッチして全体を埋めます。

  • fill:フレームをサイズ変更し、黒い罫線を保持します。

  • fit:フレームを比例的にサイズ変更し、黒い罫線を削除します。

説明

この操作では、sys/saveas および notify パラメーターも使用します。詳細については、「save as」および「メッセージ通知」をご参照ください。

関連 API

前述の操作では API 呼び出しが使用されています。高度なカスタマイズを行う場合は、REST API リクエストを直接送信できます。この場合、署名を手動で計算する必要があります。Authorization ヘッダーの計算方法については、「署名バージョン 4(推奨)」をご参照ください。

API を呼び出す前に、バケットを IMM プロジェクトにバインドする必要があります。詳細については、「バケットのバインド」をご参照ください。

AI 用に 10 秒ごとにフレームをキャプチャ

AI モデルのトレーニングまたは推論用に、10 秒ごとに画像フレームをキャプチャします。出力画像の解像度は 512x512 に制限されます。

ビデオおよびキャプチャされたフレームに関する情報

  • ソースファイル

    • ビデオ名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • キャプチャされたフレームに関する情報

      • フォーマット:JPG

      • フレームキャプチャ間隔:10 秒

      • 出力解像度:512x512

      • スケーリング方法:サイズ変更および切り取り

    • 画像ストレージパス

      • oss://outbucket/outobjprefix-%d.jpg

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

x-oss-async-process=video/snapshots,f_jpg,w_512,h_512,scaletype_crop,inter_10000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

4 秒間隔で 5 フレームをキャプチャ

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フォーマット:png

      • 開始時間:11 秒

      • 間隔:4 秒

      • フレーム数:5

      • 出力解像度:ソースビデオの幅および高さの半分

    • ファイルストレージパス

      • png ファイル:oss://outbucket/outobjprefix-%d.png

リクエスト例

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,ss_11000,f_png,pw_50,ph_50,num_5|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

ビデオからイベントキーフレームを抽出する

dhash アルゴリズムを使用してビデオフレーム間のコンテンツ類似性を分析し、指定されたしきい値に基づき視覚的変化が大きいフレームをイベントキーフレームとして抽出します。

重要

具体的なユースケースに応じて、しきい値パラメーター(thr)を調整してください。

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フレームキャプチャモード:dhash

      • フォーマット:jpg

      • しきい値:15

      • 間隔:1 秒

      • 出力解像度:ソースビデオと同じ

    • ファイルストレージパス

      • jpg ファイル:oss://outbucket/outobjprefix-%d.jpg

リクエスト例

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,m_dhash,f_jpg,inter_1000,thr_15|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

推論用に代表的なキーフレームを 5 つ抽出

dhash アルゴリズムを使用してビデオフレーム間のコンテンツ類似性を分析し、視覚的変化が最も大きいフレームを 5 つ抽出します。

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フレームキャプチャモード:dhash

      • フォーマット:jpg

      • フレーム数:5

      • 間隔:1 秒

      • 出力解像度:ソースビデオと同じ

    • ファイルストレージパス

      • jpg ファイル:oss://outbucket/outobjprefix-%d.jpg

リクエスト例

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,m_dhash,f_jpg,inter_1000,num_5|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

ビデオからすべての IDR フレームを抽出

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フレームキャプチャモード:key

      • フォーマット:jpg

      • 出力解像度:ソースビデオと同じ

    • ファイルストレージパス

      • jpg ファイル:oss://outbucket/outobjprefix-%d.jpg

リクエスト例

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,m_key,f_jpg|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

均等な間隔で 10 フレームをキャプチャ

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.mkv

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フレームキャプチャモード:avg

      • フォーマット:jpg

      • フレーム数:10

      • 出力解像度:ソースビデオと同じ

    • ファイルストレージパス

      • jpg ファイル:oss://outbucket/outobjprefix-%d.jpg

リクエスト例

// example.mkv ファイルからフレームをキャプチャします。
POST /example.mkv?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,m_avg,f_jpg,num_10|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

オーディオカバー画像を抽出

一部のオーディオファイルには埋め込みカバーアートが含まれています。フレームキャプチャ機能を使用して、このカバーアートを抽出できます。

フレームキャプチャ情報

  • ソースファイル

    • ファイル名:example.flac

  • メッセージ通知

    • MNS トピック:example-mns-topic

  • 出力構成

    • フレームキャプチャ詳細

      • フォーマット:jpg

      • 出力解像度:埋め込みカバーアートと同じ

    • ファイルストレージパス

      • jpg ファイル:oss://outbucket/cover.jpg

リクエスト例

// example.flac ファイルからフレームをキャプチャします。
POST /example.flac?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
x-oss-async-process=video/snapshots,f_jpg|sys/saveas,b_b3V0YnVja2V0,o_Y292ZXIuanBnCg/notify,topic_ZXhhbXBsZS1tbnMtdG9waWMK

課金

ビデオフレーミング機能を使用すると、IMM サービスが呼び出され、OSS および IMM の両方に以下の課金項目が発生します。

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

    API

    課金項目

    説明

    GetObject

    GET リクエスト

    料金は成功したリクエスト数に基づいて計算されます。

    アウトバウンドインターネットトラフィック料金

    パブリックエンドポイント(例:oss-cn-hangzhou.aliyuncs.com)または転送アクセラレーションエンドポイント(例:oss-accelerate.aliyuncs.com)を使用して GetObject 操作を呼び出すと、アウトバウンドインターネットトラフィック料金が発生します。この料金は転送されたデータ量に基づいて計算されます。

    低頻度アクセスデータ取得

    低頻度アクセスストレージクラスからデータを取得すると、取得されたデータ量に基づいてデータ取得料金が発生します。

    アーカイブ直接読み取りデータ取得

    アーカイブ直接読み取りが有効化されたバケットからアーカイブ済みオブジェクトを読み取ると、取得されたデータ量に基づいてデータ取得料金が発生します。

    転送アクセラレーション

    転送アクセラレーションが有効の場合、転送アクセラレーションドメイン名経由でバケットにアクセスすると、転送されたデータ量に基づいて転送アクセラレーション料金が発生します。

    PutObject

    PUT リクエスト

    料金は成功したリクエスト数に基づいて計算されます。

    ストレージ料金

    ストレージ料金は、オブジェクトのストレージクラス、サイズ、および保存期間に基づいて計算されます。

    HeadObject

    GET リクエスト

    料金は成功したリクエスト数に基づいて計算されます。

  • IMM:料金の詳細については、「IMM 課金項目」をご参照ください。

    重要

    2025 年 7 月 28 日 11:00(UTC + 08:00)より、IMM ビデオフレーミングサービスの料金が引き下げられます。この変更は VideoFraming 課金項目に適用されます。詳細については、「IMM の料金改定に関するお知らせ」をご参照ください。

    API

    課金項目

    説明

    CreateMediaConvertTask

    VideoFraming

    ビデオフレーミング料金は、正常にキャプチャされたフレーム数に基づいて計算されます。

注意事項

  • フレームキャプチャは非同期処理(x-oss-async-process)のみをサポートします。

  • ビデオのタイムスタンプまたはコードストリームのデータ破損により、フレームキャプチャが失敗したり、不正確なフレーム数が生成されたりする可能性があります。

  • 匿名アクセスは拒否されます。

よくある質問

  • フレームキャプチャはブラックスクリーンをフィルターで除外しますか?

    いいえ、フレームキャプチャはブラックスクリーンをフィルターで除外しません。

  • フレームキャプチャはサムネイル動画を生成しますか?

    いいえ、フレームキャプチャはサムネイル動画を生成しません。サムネイル動画を生成する場合は、ビデオからアニメーション画像への変換機能を使用できます。詳細については、「ビデオからアニメーション画像への変換」をご参照ください。

  • フレームキャプチャにはビデオフォーマットに関する制限がありますか?

    いいえ。フレームキャプチャはすべての主要なビデオフォーマットをサポートしています。

  • 高速モードで、フレームキャプチャで要求されたフレームが最初の 1 秒内にある場合、実際にキャプチャされたフレームは最初の 1 秒前の最新のキーフレームに近いですか?

    はい。

  • アップロードしたビデオのカバーとして特定のフレームではなくグレースケール画像が表示される場合はどうすればよいですか?

    この問題は、ビデオのビットレートが過剰に高いことが原因で発生する可能性があります。この問題を回避するには、事前にビデオをトランスコードできます。