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

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

最終更新日:Jun 11, 2026

メディアアップロードは、メディアリソースを ApsaraVideo VOD に登録することで、メディアアセット管理、メディア処理、コンテンツ配信などのダウンストリームサービスを利用できるようにします。このトピックでは、サポートされているフォーマット、アップロード方法、ストレージ設定、およびアップロード後のワークフローについて説明します。

サポート対象のメディアフォーマット

ApsaraVideo VOD は、動画、オーディオ、画像、および補助メディアアセット (ウォーターマークファイル、字幕ファイル、素材ファイル) のアップロードに対応しています。ファイルは ローカルまたは オンライン (URL からのアップロード) に対応しています。

説明

拡張子は必須です。拡張子の大文字と小文字は区別されません。MP4mp4 は同等です。

メディアタイプ

ファイルフォーマット

動画

  • MPEG フォーマット:MP4、TS、3GP、MPG、MPEG、MPE、DAT、VOB、ASF など。

  • AVI フォーマット:AVI。

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

  • Flash Video フォーマット:FLV、F4V。

  • Real Video フォーマット:RM、RMVB。

  • QuickTime フォーマット:MOV。

  • Matroska フォーマット:MKV。

  • HLS フォーマット:M3U8。

    説明

    コンソールでは、URL からの M3U8 アップロードにのみ対応しています。ローカルの M3U8 ファイルをアップロードするには、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 コンソールを使用したファイルのアップロード

迅速かつ簡単なメディアアセットのアップロード

説明

コンソールを使用した大容量ファイルのアップロードは、セッションの有効期限が切れると失敗する可能性があります。大容量ファイルの場合は、Windows クライアントを使用してください。

  • サービスを有効化した後、ApsaraVideo VOD コンソールにログインしてメディアファイルをアップロードします。

  • ローカルファイルまたは URL からの音声・動画のアップロードに対応しています。

Windows クライアントを使用したファイルのアップロード

大容量ファイルのアップロードや長時間のアップロードタスク

  • ダウンロードとインストールが必要です。Windows クライアントのみ利用可能です。

  • ローカルファイルのアップロードにのみ対応しています。

プログラム連携

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

  • 自動アップロードや大規模な動画移行

  • オンラインメディアファイルのアップロード

説明

可能な限りアップロード SDK を使用してください。提供されている SDK がお使いの言語に対応していない場合は、代わりに OSS ネイティブ SDK を使用してください。

  • サーバーサイド アップロード SDK は、アップロード認証情報とアップロード URL の取得をカプセル化し、OSS アップロード機能を統合しています。最小限の設定で済みます。

  • 対応言語は、Java、Python、PHP、C/C++ です。

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

  • 自動アップロードや大規模な動画移行

  • オンラインメディアファイルのアップロード

  • OSS ネイティブ SDK を使用する場合、完全なアップロードロジックを実装する必要があります。ApsaraVideo VOD からアップロード URL とアップロード認証情報を取得し、Base64 でデコードし、OSS オペレーションを呼び出してアップロードを完了します。

  • 対応言語は、Java、Python、PHP、.NET、Go、Node.js、C/C++ です。

    説明

    Java、Python、PHP、C/C++ の場合は、代わりに ApsaraVideo VOD アップロード SDK を使用してください。

URL によるファイルのアップロード

パブリック URL 経由でアクセス可能なファイル

  • China (Shanghai) および Singapore リージョンにのみファイルをアップロードできます。

  • この方法は、ローカルファイルのアップロードには対応していません。

アップロード方法別機能比較

次の表で、方法別のアップロード機能を比較します。

グループ

機能

コンソール

PC クライアント

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

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

UploadMediaByURL

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

OSS オブジェクトをアップロードする

メディアアセット管理

メディアタイトル

対応

対応

対応

対応

対応

対応

対応

メディアカテゴリ

対応

対応

対応

対応

対応

対応

対応

メディアタグ

非対応

対応

対応

対応

対応

対応

対応

動画サムネイル

非対応

非対応

対応

対応

対応

対応

対応

音声と動画のトランスコーディング

トランスコードテンプレートグループ

対応

対応

対応

対応

対応

対応

対応

ワークフロー

対応

非対応

対応

対応

対応

対応

対応

トランスコードなし

対応

対応

対応

対応

対応

対応

対応

アップロード制御

アップロードの進捗

対応

対応

対応

対応

対応

対応

対応

再開可能なアップロード

非対応

非対応

Java 版サーバーアップロード SDK のみ対応

対応

非対応

Java 版 OSS SDK のみ対応

非対応

マルチパートアップロード

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

デフォルトで有効

音声と動画のトランスコーディング

アップロード時にトランスコードテンプレートグループまたはメディアワークフローを指定し、トランスコーディングを設定します。アップロード完了後、トランスコーディングは自動的に開始されます。トランスコーディングを無効にすることも可能です。ただし、MP4、FLV、M3U8、MP3、WEBM 形式のファイルのみ、トランスコーディングなしで再生できます。

  • トランスコードテンプレートグループの指定:アップロード中に [Transcoding Template Group] を選択します。アップロード後、トランスコーディングが自動的に開始されます。これがデフォルトの方式です。

  • メディアワークフローの指定:トランスコーディングジョブを含むワークフローを作成し、アップロード中に [Media Workflow] を選択します。アップロード後、ワークフローが自動的に実行されます。

  • アップロード中にトランスコーディングを無効にするには、トランスコードテンプレートグループで [No Transcoding] テンプレートを選択します。

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

  • マルチパートアップロード:ファイルをパートに分割して個別にアップロードし、再結合します。デフォルトで有効です。

    説明

    マルチパートアップロードが失敗した場合、残りのパートは 7 日後に自動的に削除されます。すぐに削除するには、DeleteMultipartUpload API を呼び出してください。

  • アップロードの進捗状況とステータスを監視します。

  • レジュームアップロード:中断されたアップロードを最後に成功したパートから再開します。

    説明

    クライアントアップロード SDK には、レジュームアップロード機能が組み込まれており、ブレークポイントから自動的に再開されます。

ストレージ

ストレージリージョン

ApsaraVideo VOD は、Object Storage Service (OSS) を使用して、全世界のストレージノードにメディアアセットを保存します。各ノードは、専用のストレージアドレスを持つリージョンに対応します。

ストレージアドレス

説明

データはリージョンごとに分離され、同一アカウント内であってもリージョン間で共有されません。アップロード先のリージョンが、利用するサービスリージョンと一致していることを確認してください。

設定

説明

VODシステムストレージアドレスの有効化

ApsaraVideo VOD を有効化すると、各リージョンにデフォルトのストレージバケット (VOD システムバケット) が作成され、すぐに使用できます。詳細については「ストレージバケットの管理」をご参照ください。

ストレージアドレスの追加

お客様の OSS バケットを ApsaraVideo VOD に追加して、これらのバケット内のファイルに対して、トランスコーディング、スナップショットキャプチャ、再生を行えるようにします。詳細については「ストレージバケットの管理」をご参照ください。

デフォルトストレージアドレスの変更

複数のストレージアドレスを追加した後、デフォルトを変更できます。特に指定しない限り、アップロードはデフォルトのアドレスに送信されます。詳細については「ストレージバケットの管理」をご参照ください。

次の表に、サポートされているリージョンとリージョン ID を示します。

説明

コンソールと PC クライアントからのアップロードでは、選択したリージョンのストレージアドレスが使用されます。SDK と API によるアップロードでは、URL ベースのプルアップロード操作の StorageLocation パラメーターなどを使用して、ストレージアドレスを指定できます。

リージョン

リージョン ID

China (Shanghai)

cn-shanghai

China (Beijing)

cn-beijing

China (Shenzhen)

cn-shenzhen

China (Hong Kong)

cn-hongkong

Japan (Tokyo)

ap-northeast-1

Singapore

ap-southeast-1

Indonesia (Jakarta)

ap-southeast-5

Germany (Frankfurt)

eu-central-1

US (Silicon Valley)

us-west-1

課金

ApsaraVideo VOD のストレージは、従量課金 (後払い) またはリソースプラン (前払い) で課金されます。

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

ApsaraVideo VOD は、各アップロード後に HTTP(S) または MNS のコールバックでイベント通知を送信します。 処理ステータスの更新を受信するには、コールバックを設定してください。 次の表に、アップロードイベントを示します。

説明

イベントの全詳細:イベント通知

イベント名

タイプ

説明

Video Upload Complete

FileUploadComplete

音声または動画ファイルのアップロードが完了した後にトリガーされます。

説明

トランスコーディングされていない音声または動画ファイルの場合、再生 URL は FileUploadComplete イベントの後にのみ利用可能になります。

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

Image Upload Complete

ImageUploadComplete

画像ファイルのアップロードが完了した後にトリガーされます。

Auxiliary Media Upload Complete

AttachedMediaUploadComplete

補助メディアアセットのアップロードが完了した後にトリガーされます。

Video Upload from URL Complete

UploadByURLComplete

UploadMediaByURL 操作による動画の取得とアップロードが完了したときにトリガーされます。

Transcode complete for a single stream

StreamTranscodeComplete

ビデオストリームが特定の解像度とフォーマット (例:MP4 形式の SD) にトランスコーディングされたときにトリガーされます。

説明

トランスコーディングされたファイルの場合、再生 URL を取得する前に StreamTranscodeComplete イベントを待機してください。このコールバックを受信する前に再生すると失敗する可能性があります。

Video Transcode Complete

TranscodeComplete

ビデオ内の全ストリームのトランスコーディングが完了したときにトリガーされます。

説明

すべての解像度が利用可能であることを確認するために、TranscodeComplete イベントを待機してください。このコールバックの前に再生すると失敗する可能性があります。

アップロードの権限付与

開発者によるアップロードでは、悪意のあるアップロードや不正な再生を防ぐため、アップロード認証情報または Security Token Service (STS) トークンで権限を付与します。

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

アップロードアクセラレーションは、長距離転送や大容量ファイル (GB/TB) の転送を改善します。中国本土から Singapore リージョンのバケットへ動画を転送するなど、クロスリージョンのアップロードに最適です。

有効化方法

アップロードアクセラレーションを有効にするには、チケットを送信してください。アカウント ID と、アクセラレーション対象の バケット を指定してください。

課金

アップロードアクセラレーションは、使用量に基づいて課金されます (転送アクセラレーションの課金)。

説明

この機能を使用しない場合、課金は発生しません。

制限事項

ApsaraVideo VOD コンソールを使用してファイルをアップロードする以外のすべてのアップロード方法で、アクセラレーションがサポートされています。

次のステップ

説明

アップロードされたメディアアセットには、処理段階に基づいてステータスが割り当てられます。アップロード中アップロード失敗、またはブロック済みのステータスのメディアアセットは、削除のみ可能です。正常ステータスのメディアアセットは、トランスコーディング、スナップショットキャプチャ、レビュー、再生のすべての操作をサポートします。詳細については、「動画ステータス」および「画像ステータス」をご参照ください。

次の表に、アップロード後のサービスと再生に関する考慮事項を示します。

サービス

説明

参考資料

メディア資産管理 (アップロード後)

アップロードされたメディアファイル (ソース動画、トランスコードされたストリーム、画像を含む) を管理します。

メディア資産管理

メディア処理

アップロード後の操作には、トランスコーディング、自動レビュー、オンライン編集、AI 処理が含まれます。

説明

ApsaraVideo VOD は、動画のメタデータ (解像度、デュレーション、ビットレート) を自動的に抽出し、サムネイルとスプライトをキャプチャします。これらの前処理操作は無料です。

メディア処理

音声と動画の再生

アップロードされたファイルは、すぐには再生できません。イベント通知が、ファイルの準備が完了したことを通知します。

  • トランスコードされていないファイル:FileUploadComplete イベント後に再生 URL が利用可能になります。

  • トランスコードされたファイル:StreamTranscodeComplete イベント後に再生 URL が利用可能になります。すべての画質が準備できたことを確認するには、TranscodeComplete イベントを待ってください。