複数の処理パラメーターをスタイルにグループ化することで、複雑なメディア、ドキュメント、または画像処理を迅速に実行できます。
データ処理機能の API と SDK は、Intelligent Media Management (IMM) のエンドポイントがあるリージョンで利用できます。
カスタムスタイルの使用
スタイルの作成
1 つのバケットに最大 50 個のスタイルを作成できます。 これらのスタイルは、同じバケット内のファイルにのみ適用されます。 より多くのスタイルが必要な場合は、テクニカルサポートまでご連絡ください。
処理したいファイルの種類に応じて、画像処理、ドキュメント処理、またはApsaraVideo Media Processingを選択します。
スタイル管理 タブを選択し、次に スタイルを作成 をクリックします。
スタイルを作成 パネルで、スタイルを設定します。
OK をクリックします。
スタイルの使用
スタイルを作成した後、オブジェクト URL や非同期リクエストを使用してファイルを処理できます。
オブジェクト URL を使用した同期処理
オブジェクトを同期処理するには、URL に次のフォーマットでスタイルを追加します： http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName。 次の表に各パラメーターを説明します。
パラメーター | 説明 | 例 |
| オブジェクトの URL。 オブジェクト URL の取得方法の詳細については、「1 つ以上のファイルの URL を取得」をご参照ください。 | |
| スタイルを使用した処理を指定する固定パラメーターです。 | |
| カスタムスタイルの名前です。 |
カスタム区切り文字の指定やカスタムドメイン名のマッピングにより、処理 URL を簡略化できます。 例：
区切り文字
!を使用してx-oss-process=style/を置き換えます。カスタムドメイン名をバケットにマッピングして、URL をさらに簡略化します。 詳細については、「カスタムドメイン名のマッピング」をご参照ください。
例えば、カスタムドメイン名 example.com をバケットにマップした場合、https://example.com/example.jpg!small を使用してイメージをプロセスできます。
オンラインプレビューにはカスタムドメイン名が必要です。 2022年10月9日 00:00:00 (UTC + 08:00) 以降、新規に作成されたバケットでは、カスタムドメイン名がマップされていない限り、オンラインプレビューは無効化されます。 詳細については、公式の発表をご参照ください。
スタイルを使用した非同期処理
x-oss-async-process=style/StyleName を使用して、ファイルを非同期処理できます。 以下に例を示します：
POST /ObjectName?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
// StyleName スタイルを使用してファイル example.avi を非同期に処理し、出力を oss://outbucket/outobjprefix.mp4 に保存します。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ次の表に各パラメーターを説明します。
パラメーター | 説明 |
| オブジェクトの名前です。 |
| スタイルを使用した処理を指定する固定パラメーターです。 |
| カスタムスタイルの名前です。 |
組み込みスタイルの使用
カスタムスタイルに加えて、組み込みスタイルを使用してファイルを処理することもできます。
スタイルを使用した非同期処理
x-oss-async-process=style/::systemStyleName を使用して、組み込みスタイルでファイルを非同期に処理できます。 以下にリクエストの例を示します：
POST /ObjectName?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
// 組み込みスタイル h264-mp4-1080p を使用してファイル example.avi を非同期に処理し、出力を oss://outbucket/outobjprefix.mp4 に保存します。
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ次の表に各パラメーターを説明します。
パラメーター | 説明 |
| オブジェクトの名前です。 |
| スタイルを使用した処理を指定する固定パラメーターです。 |
| 組み込みスタイルを示します。 |
| 組み込みスタイルの名前です。 説明 サポートされているすべての組み込みスタイルパラメーターは、データ処理>ApsaraVideo Media Processing ページで確認できます。 |
バケット間でのスタイルのインポート
この機能は IMG スタイルのみをサポートします。
ソースバケットからスタイルをエクスポートし、宛先バケットにインポートできます。 これにより、同じスタイルを迅速に適用して、宛先バケット内の画像ファイルを処理できます。
ソースバケットからスタイルをエクスポートします。
ソースバケットの管理ページで、データ処理>画像処理 を選択します。
画像処理 ページで、スタイルをエクスポート をクリックします。
表示されるダイアログボックスで、スタイルファイルの保存先を選択し、設定 をクリックします。
宛先バケットにスタイルをインポートします。