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

ApsaraVideo VOD:メディアアップロードの概要

最終更新日:Nov 09, 2025

メディアアップロードは、メディアリソースを ApsaraVideo VOD に登録するプロセスです。これは、メディアアset管理、メディア処理、コンテンツ配信、再生などの他の ApsaraVideo VOD サービスを使用するための前提条件です。このトピックでは、ApsaraVideo VOD のメディアアセットでサポートされているメディア形式、アップロード方法、アップロード設定、および使用上の注意について説明します。

サポートされているメディア形式

ApsaraVideo VOD では、ビデオ、オーディオファイル、画像、ウォーターマークファイル、字幕ファイル、素材ファイルなどの補助メディアアセットなど、さまざまなメディアファイルをアップロードできます。ファイルは ローカルファイル または オンラインファイル (オンラインファイルは URL でアップロード) にすることができます。次の表に、各種類のメディアアsetでサポートされているファイル形式を示します。

説明

メディアファイルを ApsaraVideo VOD にアップロードするには、メディアファイルのパスにファイル名拡張子を含める必要があります。ファイル名拡張子では大文字と小文字は区別されません。たとえば、MP4 と mp4 はどちらも有効なファイル名拡張子です。

メディアタイプ

サポートされているファイル形式

ビデオ

  • MPEG 形式: MP4、TS、3GP、MPG、MPEG、MPE、DAT、VOB、および ASF。

  • AVI フォーマット:AVI。

  • Windows Media Video フォーマット: WMV と ASF。

  • Flash ビデオフォーマット: FLV と F4V。

  • Real Video フォーマット: RM および RMVB。

  • QuickTime フォーマット: MOV。

  • Matroska フォーマット: MKV。

  • HLS フォーマット: M3U8。

    説明

    ApsaraVideo VOD コンソール経由で M3U8 ファイルをアップロードする場合、URL アップロードメソッドのみを使用できます。ローカルの M3U8 ファイルの場合、ApsaraVideo VOD API または SDK を使用してアップロードできます。詳細については、「ApsaraVideo VOD API を使用してメディアファイルをアップロードする」をご参照ください。

  • その他のフォーマット:DV、GIF、M2T、M4V、MJ2、MJPEG、MTS、OGG、QT、SWF、および WEBM。

オーディオ

MP3、WMA、WAV、AAC、RA、M4A、FLAC、APE、AC3、AMR、CAF、および ACM。

イメージ

PNG、JPG、JPEG、GIF、および HEIC。

補助メディアアセット

  • ウォーターマークファイル: PNG、GIF、APNG、および MOV。

  • 字幕ファイル: SRT、ASS、STL、TTML、および VTT。

  • 素材ファイル: JPG、GIF、PNG、MP4、MAT、および ZIP。

説明

ApsaraVideo VOD には、前述の種類のメディアアセットのみをアップロードできます。他の種類のファイルについては、「OSS へのファイルのアップロード」に記載されている手順に従ってください。

アップロード方法

ApsaraVideo VOD は、さまざまなシナリオに対応する手動アップロードと自動アップロードの方法を提供します。

アップロード方法

シナリオ

説明

手動アップロード

ApsaraVideo VOD コンソール経由でファイルをアップロードする

ApsaraVideo VOD コンソールは、メディアファイルをアップロードするための迅速で便利な方法です。

説明

コンソールセッションの長さはセキュリティポリシーによって制御されます。完了までに時間がかかる大きなファイルをアップロードすると、アップロードが完了する前にコンソールセッションの有効期限が切れることがあります。この場合、PC クライアントを使用して大きなファイルをアップロードすることをお勧めします。

  • ApsaraVideo VOD をアクティベートした後、ブラウザで ApsaraVideo VOD コンソールにログインしてメディアファイルをアップロードできます。

  • オンプレミスデバイスから、またはファイルの URL を使用して、オーディオおよびビデオファイルをアップロードできます。

Windows クライアントを使用してファイルをアップロードする

PC クライアントは、完了までに時間がかかる大きなファイルのアップロードや、制作に対する強い要件がないシナリオに適しています。

  • PC クライアントをダウンロードしてインストールする必要があります。ApsaraVideo VOD は、Windows オペレーティングシステム用の PC クライアントを提供します。

  • ローカルファイルのみアップロードできます。

プログラム統合

アップロード SDK を使用してファイルをアップロードする

  • 自動アップロードが必要なシナリオ、または多数のビデオファイルをアップロードしたいシナリオ。

  • オンラインメディアファイルをアップロードしたいシナリオ。

説明

メディアファイルのアップロードには、アップロード SDK を使用することをお勧めします。ApsaraVideo VOD のアップロード SDK が希望のプログラミング言語をサポートしていない場合は、OSS SDK を使用してメディアファイルをアップロードできます。

  • サーバーアップロード SDK は、ApsaraVideo VOD での アップロード資格情報と URL の取得 のロジックと OSS のアップロード機能をカプセル化します。簡単な構成でアップロード機能を実装できます。

  • Java、Python、PHP、および C または C++ がサポートされています。

OSS SDK を使用してファイルをアップロードする

  • 自動アップロードが必要なシナリオ、または多数のビデオファイルをアップロードしたいシナリオ。

  • オンラインメディアファイルをアップロードしたいシナリオ。

  • OSS SDK を使用する場合、ApsaraVideo VOD からのアップロード URL と資格情報の取得、アップロード資格情報と URL の Base64 デコード、OSS 機能の呼び出しによるアップロードの完了など、すべてのアップロードロジックを実装する必要があります。

  • OSS SDK は、Java、Python、PHP、.NET、Node.js、C、C++、および Go プログラミング言語をサポートしています。

    説明

    Java、Python、PHP、C、または C++ プログラミング言語を使用する場合は、アップロード SDK を使用することをお勧めします。

URL でファイルをアップロードする

オンプレミスサーバーまたは端末に保存されておらず、パブリック URL を使用してアクセスできるファイルをアップロードしたいシナリオ。

  • 中国 (上海) および シンガポール リージョンにのみファイルをアップロードできます。

  • ローカルファイルはアップロードできません。

さまざまなアップロード方法でサポートされている機能の比較

次の表に、アップロード中に さまざまなアップロード方法でサポートされている機能を示します。

グループ

機能

コンソール

PC クライアント

サーバーからのアップロード

クライアントからのアップロード

UploadMediaByURL

OSS SDK を使用したファイルのアップロード

OSS へのファイルのアップロード

リソース管理

メディアアセットのタイトルを設定

サポート

サポート

サポート

サポート

サポート

サポート

サポート

メディアアセットのカテゴリを設定

サポート

サポート

サポート

サポート

サポート

サポート

サポート

メディアアセットのタグを設定

非サポート

サポート

サポート

サポート

サポート

サポート

サポート

ビデオファイルのサムネイルを設定

非サポート

非サポート

サポート

サポート

サポート

サポート

サポート

オーディオとビデオのトランスコーディング

トランスコーディングテンプレートグループ

サポート

サポート

サポート

サポート

サポート

サポート

サポート

ワークフロー

サポート

非サポート

サポート

サポート

サポート

サポート

サポート

トランスコーディングを無効にする

サポート

サポート

サポート

サポート

サポート

サポート

サポート

アップロードコントロール

アップロードの進捗状況を取得

サポート

サポート

サポート

サポート

サポート

サポート

サポート

再開可能なアップロードを実行

非サポート

非サポート

Java 用アップロード SDK のみがこの機能をサポート

サポート

非サポート

Java 用 OSS SDK のみがこの機能をサポート

非サポート

マルチパートアップロードを実行

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

オーディオとビデオのトランスコーディング

アップロード設定を構成するときに、トランスコーディングテンプレートグループまたはメディアワークフローを指定して、オーディオおよびビデオファイルをトランスコーディングできます。アップロードが完了すると、トランスコーディングが自動的にトリガーされます。トランスコーディングを無効にすることもできます。ただし、トランスコーディングなしで再生できるのは、MP4、FLV、M3U8、MP3、WEBM 形式のファイルのみです。

  • トランスコーディングテンプレートグループの指定: トランスコーディングテンプレートグループの指定は、ApsaraVideo VOD のデフォルトの処理方法です。アップロード設定を構成するときに トランスコーディングテンプレートグループ を選択できます。アップロードが完了すると、トランスコーディングが自動的にトリガーされます。

  • メディアワークフローの指定: トランスコーディングタスクを含むメディアワークフローを作成した後、アップロード設定を構成するときに メディアワークフロー を選択できます。アップロードが完了すると、ApsaraVideo VOD は指定されたメディアワークフローを自動的に実行してトランスコーディングジョブを完了します。

  • トランスコーディングの無効化: アップロード中にファイルをトランスコーディングする必要がない場合は、トランスコーディングテンプレートグループで トランスコーディングなし テンプレートを選択できます。

アップロードコントロール

  • マルチパートアップロードの実行: ApsaraVideo VOD は、アップロード中にメディアファイルを複数のパートに分割し、アップロード完了後にアップロードされたパートを結合します。デフォルトでは、すべてのメディアファイルはマルチパートアップロードモードで ApsaraVideo VOD にアップロードされます。

    説明

    マルチパートアップロード中にアップロードが失敗した場合、不要なパートが保持されることがあります。これらの不要なパートは 7 日後に自動的に削除されます。DeleteMultipartUpload 操作を呼び出して、不要なパートを手動で削除することもできます。

  • アップロードの進捗状況とステータスの取得。

  • 再開可能なアップロードの実行。ネットワークエラーによりメディアファイルのアップロードに失敗した場合、ApsaraVideo VOD は最後に正常にアップロードされたパートからアップロードを再開します。

    説明

    再開可能なアップロードは、クライアントアップロード SDK 内に実装されています。例外によりメディアファイルのアップロードに失敗した場合、ユーザーの介入なしに記録された位置からアップロードが再開されます。

ストレージ

ストレージリージョン

ApsaraVideo VOD は、メディアアセットを Object Storage Service (OSS) に保存します。ApsaraVideo VOD のストレージノードはグローバルに分散しています。各ストレージノードはストレージリージョンを表します。各ストレージリージョンには、ApsaraVideo VOD によってストレージの場所が割り当てられます。

ストレージの場所

説明

ApsaraVideo VOD では、同じアカウントのデータであっても、リージョン間のデータアクセスは許可されていません。メディアファイルをアップロードする前に、ビジネスが所在するリージョンにメディアファイルをアップロードしていることを確認してください。そうしないと、意図した場所でメディアファイルを使用できない場合があります。

ストレージの場所の設定

説明

VOD システムストレージの場所を有効にする

ApsaraVideo VOD をアクティベートすると、各リージョンに独立したバケットが割り当てられます。リージョン内のメディアリソースをアップロードおよび管理する前に、バケットを有効にする必要があります。他の構成は必要ありません。詳細については、「ストレージバケットの管理」をご参照ください。

ストレージの場所を追加

OSS バケットを ApsaraVideo VOD に追加できます。これにより、OSS バケットに保存されているメディアファイルに対して、トランスコーディング、スナップショットキャプチャ、再生などの操作を実行できます。詳細については、「ストレージバケットの管理」をご参照ください。

デフォルトのストレージの場所を変更

複数のリージョンでストレージの場所を有効にした後、デフォルトのストレージの場所を変更できます。アップロードするメディアファイルのストレージの場所を指定できます。ストレージの場所を指定しない場合、メディアファイルはデフォルトのストレージの場所にアップロードされます。詳細については、「ストレージバケットの管理」をご参照ください。

次の表に、ApsaraVideo VOD がサポートするストレージリージョンと対応するリージョン ID を示します。

説明

URL ベースのプルアップロード ApsaraVideo VOD コンソールまたは PC クライアントを使用してメディアファイルをアップロードする場合、システムは ApsaraVideo VOD サービスにアクセスするリージョンのストレージの場所を使用します。SDK または API 操作を使用してメディアファイルをアップロードする場合、UploadMediaByURL 操作の StorageLocation パラメーターなどのパラメーターを使用してストレージの場所を指定できます。

ストレージリージョン

リージョン ID

中国 (上海)

cn-shanghai

中国 (北京)

cn-beijing

中国 (深圳)

cn-shenzhen

中国 (香港)

cn-hongkong

日本 (東京)

ap-northeast-1

シンガポール

ap-southeast-1

インドネシア (ジャカルタ)

ap-southeast-5

ドイツ (フランクフルト)

eu-central-1

米国 (シリコンバレー)

us-west-1

保存データに対する課金

ApsaraVideo VOD は、消費されたストレージリソースに対して、従量課金またはサブスクリプション課金方法 (リソースプラン) に基づいて課金します。

アップロードイベント通知

コールバックを設定して、メディアファイルのアップロード後にアップロードの進捗状況とステータスに関するイベント通知を受信できます。ApsaraVideo VOD では、HTTP または HTTPS および Message Service (MNS) コールバックを設定してイベント通知を取得できます。コールバックの詳細については、「イベント通知」をご参照ください。コールバックの設定方法の詳細については、「コールバックの設定」をご参照ください。すべてのアップロード方法でイベント通知がサポートされています。次の表にアップロードイベントを示します。

説明

各イベントの詳細については、「イベント通知」をご参照ください。

イベント名

イベントタイプ

説明

FileUploadComplete

FileUploadComplete

FileUploadComplete イベントは、オーディオおよびビデオファイルのアップロードが完了したときに生成されます。

説明

トランスコーディングされていないオーディオおよびビデオファイルの場合、FileUploadComplete イベント通知を受信した後に再生 URL を取得できます。

アップロード中にトランスコーディングを無効にした場合、FileUploadComplete イベント通知を受信した後に SubmitTranscodeJobs 操作を呼び出してファイルをトランスコーディングできます。

ImageUploadComplete

ImageUploadComplete

ImageUploadComplete イベントは、画像ファイルのアップロードが完了したときに生成されます。

AttachedMediaUploadComplete

AttachedMediaUploadComplete

AttachedMediaUploadComplete イベントは、補助メディアアセットのアップロードが完了したときに生成されます。

UploadByURLComplete

UploadByURLComplete

UploadByURLComplete イベントは、UploadMediaByURL 操作を呼び出して URL でビデオをアップロードした後に生成されます。

StreamTranscodeComplete

StreamTranscodeComplete

StreamTranscodeComplete イベントは、ビデオストリームが特定の解像度と形式 (MP4 形式の SD ストリームなど) にトランスコーディングされたときに生成されます。

説明

トランスコーディングされたオーディオおよびビデオファイルの場合、StreamTranscodeComplete イベント通知を受信した後に再生 URL を取得できます。コールバックを受信する前にビデオファイルを再生すると、再生が失敗することがあります。

TranscodeComplete

TranscodeComplete

TranscodeComplete イベントは、ビデオのすべてのトランスコーディングされたストリームが生成されたときに生成されます。

説明

再生前にすべての解像度が利用可能であることを確認したい場合は、TranscodeComplete イベント通知を受信するまで待つことができます。コールバックを受信する前にオーディオまたはビデオファイルを再生すると、再生が失敗することがあります。

アップロード権限付与

開発者アップロード シナリオでは、アップロード資格情報またはセキュリティトークンサービス (STS) トークンを使用して、アップロード中の権限付与とセキュリティの問題を解決できます。これにより、メディアファイルの不正なアップロードと再生を防ぎます。

アップロードアクセラレーション

ApsaraVideo VOD は、長距離でのファイル転送やギガバイトまたはテラバイトサイズのファイルのアップロードを高速化するためのアップロードアクセラレーション機能を提供します。アップロードアクセラレーションは、中国本土から シンガポール リージョンへのファイルのアップロードなど、リージョン間のアップロードに適しています。

アクティベーション

アップロードアクセラレーション機能を有効にするには、チケットを送信してください。アップロードアクセラレーションを有効にしたい [Alibaba Cloud アカウント UID][ストレージの場所] を提供する必要があります。

課金

アップロードアクセラレーション機能の使用には料金がかかります。これは ApsaraVideo VOD が提供する付加価値機能です。課金の詳細については、「転送アクセラレーションの課金」をご参照ください。

説明

アップロードアクセラレーションを有効にしても、機能を使用しない場合は料金は発生しません。

制限

ApsaraVideo VOD コンソール経由でのファイルのアップロード のみがアップロードアクセラレーションをサポートしていません。他のすべてのアップロード方法はアップロードアクセラレーションをサポートしています。

次のステップ

説明

メディアファイルが ApsaraVideo VOD にアップロードされると、処理の進捗状況に基づいてさまざまなステータスになります。ステータスが異なると、ApsaraVideo VOD でサポートされる操作も異なります。たとえば、アップロード中アップロード失敗、または ブロック済み ステータスのオーディオおよびビデオファイルは削除しかできません。これらのファイルに対して、トランスコーディング、スナップショットキャプチャ、メディアレビューなどの他の操作は実行できません。通常 ステータスのオーディオおよびビデオファイルは、トランスコーディング、スナップショットキャプチャ、メディアレビュー、再生など、すべての操作をサポートします。メディアステータスの詳細については、「ステータス: ビデオステータス」および「ステータス: 画像ステータス」をご参照ください。

次の表に、アップロードされたメディアファイルに関連する ApsaraVideo VOD の機能の使用上の注意を示します。

ApsaraVideo VOD サービス

説明

リファレンス

メディアアセット管理 (アップロード後)

ApsaraVideo VOD では、ソースビデオファイル、トランスコーディングされたストリームファイル、画像ファイルなど、アップロードされたメディアファイルを管理できます。

メディアアセット管理

メディア処理

ApsaraVideo VOD は、アップロードされたメディアファイルに対して、オーディオとビデオのトランスコーディング、自動レビュー、オンライン編集、AI 処理をサポートしています。

説明

ApsaraVideo VOD は、アップロードされたオーディオおよびビデオファイルからメタデータ (ビデオ解像度、デュレーション、ビットレートなど) を自動的に抽出します。ビデオの場合、ApsaraVideo VOD はサムネイルとスプライトも自動的にキャプチャします。これらの前処理操作は無料です。

メディア処理

オーディオとビデオの再生

オーディオおよびビデオファイルがアップロードされた後、すぐに再生できるわけではありません。ApsaraVideo VOD は、オーディオおよびビデオファイルが受信されたことを確認する必要があります。イベント通知を確認することで、オーディオおよびビデオファイルが再生可能かどうかを判断できます。

  • トランスコーディングされていないオーディオおよびビデオファイルの場合、FileUploadComplete イベント通知を受信した後に再生 URL を取得できます。

  • トランスコーディングされたオーディオおよびビデオファイルの場合、StreamTranscodeComplete イベント通知を受信した後に再生 URL を取得できます。再生前にすべての解像度が利用可能であることを確認したい場合は、TranscodeComplete イベント通知を受信するまで待つことができます。