すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:編集および制作パラメーター

    ドキュメントセンター

    Intelligent Media Services:編集および制作パラメーター

    最終更新日:Nov 09, 2025

    このトピックでは、一般的な編集および制作パラメーターについて説明します。

    OutputMediaConfig

    メディアファイルの設定。値は JSON 形式である必要があります。Object Storage Service (OSS) バケット内のメディアファイルの URL、または ApsaraVideo VOD 内のメディアファイルのストレージの場所を指定できます。メディアファイルを OSS バケットに保存する場合は、MediaURL フィールドを指定する必要があります。メディアファイルを ApsaraVideo VOD に保存する場合は、StorageLocation および FileName フィールドを指定する必要があります。

    パラメーター

    パラメーター

    タイプ

    必須

    説明

    MediaURL

    String

    メディアファイルを OSS バケットに保存する場合、このフィールドは必須です。

    OSS バケット内のメディアファイルの URL。

    例: http://-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4

    次の情報に注意してください:

    1. OSS バケットが、呼び出すサービスと同じリージョンにあることを確認してください。

    2. OSS アクセラレーションエンドポイントまたは Content Delivery Network (CDN) ドメイン名は指定できません。

    3. サポートされている出力フォーマットの詳細については、「編集でサポートされているメディアアセットフォーマット」をご参照ください。

    StorageLocation

    String

    メディアファイルを ApsaraVideo VOD に保存する場合、このフィールドは必須です。

    ApsaraVideo VOD 内のメディアファイルのストレージの場所。値には http:// プレフィックスは含まれません。

    例: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

    FileName

    String

    メディアファイルを ApsaraVideo VOD に保存する場合、このフィールドは必須です。

    ApsaraVideo VOD 内のメディアファイルの名前。ファイル名にはファイルサフィックスが含まれますが、ファイルパスは含まれません。

    例: outputVod.mp4

    Video

    String

    いいえ

    出力ビデオとビデオストリームの設定。詳細については、「ビデオの詳細」をご参照ください。

    Width

    Integer

    いいえ

    出力ビデオの幅。このパラメーターは空のままにできます。デフォルト値は、入力素材の最大幅です。

    Height

    Integer

    いいえ

    出力ビデオの高さ。このパラメーターは空のままにできます。デフォルト値は、入力素材の最大高さです。

    Bitrate

    Integer

    いいえ

    出力ビデオのビットレート。単位: Kbit/s。このパラメーターは空のままにできます。デフォルト値は、複数のビデオの最大ビットレートです。

    MaxDuration

    Float

    いいえ

    出力ビデオの最大期間。単位: 秒。このパラメーターの使用方法の詳細については、「MaxDuration の設定」をご参照ください。

    ProduceTemplateId

    String

    いいえ

    カスタムパラメーター。制作テンプレートの ID で、MPS トランスコーディングテンプレートの ID と同じです。このパラメーターは、出力ビデオの制作およびトランスコーディングパラメーターを設定するために使用されます。このフィールドを使用して、制作されたビデオをトランスコードし、特定のシナリオでカスタマイズされたビデオを処理できます。MPS でトランスコーディングテンプレートを作成できます。

    VodTemplateGroupId

    String

    いいえ

    出力ビデオを ApsaraVideo VOD に保存する場合、VOD のトランスコーディングテンプレートグループを指定する必要があります。ApsaraVideo VOD コンソールからトランスコーディングテンプレートグループの ID を取得できます。制作されたビデオをトランスコードする必要がない場合は、このフィールドを VOD_NO_TRANSCODE に設定します。詳細については、「トランスコーディングテンプレート」をご参照ください。

    Endpoint

    String

    いいえ

    • クラウド サービス プロバイダー (CSP) のエンドポイント。

    • S3 を使用する場合、このフィールドは必須です。

    Bucket

    String

    いいえ

    • S3 バケット。

    • S3 を使用する場合、このフィールドは必須です。

    ObjectKey

    String

    いいえ

    • オブジェクト名。

    • S3 を使用する場合、このフィールドは必須です。

    AccessKeyId

    String

    いいえ

    • クラウド サービス プロバイダー (CSP) から取得した一時的な AccessKey ID。

    • Amazon Simple Storage Service (S3) を使用する場合、このフィールドは必須です。

    AccessKeySecret

    String

    いいえ

    • クラウド サービス プロバイダー (CSP) から取得した一時的な AccessKey Secret。

    • S3 を使用する場合、このフィールドは必須です。

    ビデオの詳細

    出力ビデオとビデオストリームの設定を指定する OutputMediaConfig パラメーターのフィールド。次の表に設定例を示します。

    パラメーター

    タイプ

    必須

    意味

    説明

    Fps

    Integer

    いいえ

    出力ビデオストリームのフレームレート。

    • 有効な値: 1～60。

    • デフォルト値: 25。

    Orientation

    String

    いいえ

    ビデオが表示される印刷の向きモード。

    • 有効な値: Horizontal および Vertical。

    • Horizontal: 横向きモード。

    • Vertical: 縦向きモード。

    • このフィールドを Horizontal に設定すると、システムは横向きモードのすべてのビデオの中で最も幅の広いビデオの幅と高さに基づいて、出力ビデオの最大幅と高さを決定します。

    • このフィールドを Vertical に設定すると、システムは縦向きモードのすべてのビデオの中で最も高さの高いビデオの幅と高さに基づいて、出力ビデオの最大幅と高さを決定します。

    • Width および Height フィールドを指定した場合、このフィールドは有効になりません。

    Codec

    String

    いいえ

    エンコード形式。

    • 有効な値: H.264 および H.265。

    • デフォルト値: H.264。

    Profile

    String

    いいえ

    ビデオエンコードプロファイル。

    • 有効な値: baseline、main、high。

    • デフォルト値: high。

    • 注: このフィールドは、Codec フィールドが H.264 に設定されている場合にのみ有効です。

    Crf

    Integer

    いいえ

    固定レート係数。

    • 有効な値: 0～51。

    • デフォルト値:

      • Codec を H.264 に設定した場合、このフィールドはデフォルトで 23 です。

      • Codec を H.265 に設定した場合、このフィールドはデフォルトで 26 です。

    • 注: Crf および Bitrate フィールドを指定した場合、Bitrate フィールドは有効になりません。

    Preset

    String

    いいえ

    プリセットビデオアルゴリズム。

    • 有効な値: veryfast、fast、medium、slow、slower。

    • デフォルト値: medium。

    • 注: このフィールドは、Codec フィールドが H.264 に設定されている場合にのみ有効です。

    例

    OSS への出力

    メディアファイルを OSS バケットに保存する場合は、MediaURL フィールドを指定する必要があります。他のフィールドはオプションです。Bitrate フィールドは、出力ビデオのビットレートを指定します。ビットレートが高いほど、ビデオは鮮明になります。Bitrate フィールドの最大値は 5000 です。Width および Height フィールドは、ビデオの解像度を指定します。

    {
 "MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
 "Bitrate": 2000,  
 "Width": 800,  
 "Height": 680
}

    OSS URL の形式: https://${bucket}.${oss-region-name}.aliyuncs.com/${fileKey}

    bucket は OSS バケットの名前で、fileKey は OSS オブジェクトの名前です。OSS オブジェクトの名前には、オブジェクトパスとサフィックスが含まれます。

    oss-region-name.aliyuncs.com は、OSS バケットのパブリックエンドポイントです。次のコードは、中国 (上海)、中国 (杭州)、および中国 (北京) リージョンのパブリックエンドポイントを提供します:

    oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

    VOD

    メディアファイルを ApsaraVideo VOD に保存する場合は、StorageLocation および FileName フィールドを指定する必要があります。VOD コンソールで ApsaraVideo VOD の利用可能なストレージの場所を表示できます。

    { 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "outputVod.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680,
  "VodTemplateGroupId": "VOD_NO_TRANSCODE"
}

    Video フィールドの設定例

    OutputMediaConfig パラメーターの Video フィールドの設定例。

    {
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
  "Width": 800,
  "Height": 680,
  "Video": {
    "Codec": "H.264",
    "Fps": 50,
    "Profile": "main",
    "Crf": 15
  }
}

    ProjectMetadata

    編集プロジェクトのメタデータ。値は JSON 形式です。

    パラメーター

    パラメーター

    タイプ

    必須

    説明

    Description

    String

    いいえ

    編集プロジェクトの説明。

    Title

    String

    いいえ

    編集プロジェクトのタイトル。

    例

    {
   "Description":"Description",
   "Title":"Title"
}

    EditingProduceConfig

    JSON 形式の一般的な編集および制作のパラメーター。

    パラメーター

    パラメーター

    タイプ

    必須

    説明

    AudioChannelCopy

    String

    いいえ

    コピーするオーディオチャンネル。有効な値: left および right。このフィールドを left に設定すると、システムは出力ビデオの左右のオーディオチャンネルを入力ビデオの左のオーディオチャンネルとしてコピーします。このフィールドを right に設定すると、システムは出力ビデオの左右のオーディオチャンネルを入力ビデオの右のオーディオチャンネルとしてコピーします。

    AutoRegisterInputVodMedia

    Boolean

    いいえ

    タイムライン内の ApsaraVideo VOD メディアファイルを Intelligent Media Services (IMS) メディアアセットライブラリに自動的に登録するかどうかを指定します。デフォルト値: true。

    AutoRegisterOutputImsMedia

    Boolean

    いいえ

    編集および制作後に生成されたビデオを IMS メディアアセットライブラリに自動的に登録するかどうかを指定します。デフォルト値: true。

    OutputWebmTransparentChannel

    Boolean

    いいえ

    WebM 形式でアルファチャンネル付きのビデオをエクスポートするかどうかを指定します。デフォルト値: false。WebM 形式でアルファチャンネル付きのビデオをエクスポートする場合は、OutputMediaConfig パラメーターの MediaURL または FileName フィールドが webm で終わり、タイムラインで Scale Effect のみが利用可能であることを確認してください。そうでない場合、デフォルトではアルファチャンネルなしの MP4 形式のビデオがエクスポートされます。

    CoverConfig

    JSON

    いいえ

    サムネイル。ビデオ内のフレームをサムネイルとして使用できます。サムネイルはイメージとして保存され、OSS バケットに保存されます。サムネイルを使用してビデオの最初のフレームを変更することはできません。GetMediaInfo 操作を呼び出して、サムネイルの URL をクエリできます。

    • StartTime: ビデオ内のサムネイルの時点。値は小数点以下 4 桁に四捨五入できます。単位: 秒。

    InputMediaRegisterConfig

    JSON

    いいえ

    編集タイムラインに URL が含まれている場合、システムは URL をメディアアセットとして自動的に登録します。このフィールドは、入力素材をメディアアセットとして登録するための設定を指定します。

    • NeedSnapshot: メディアファイルのスナップショットを自動的にキャプチャするかどうかを指定します。タイプはブール値です。デフォルト値: true。

    • NeedSprite: スナップショットを使用してメディアファイルのスプライトを生成するかどうかを指定します。タイプはブール値です。デフォルト値: true。

    • SearchLibName: カスタム検索ライブラリの名前。タイプは文字列です。デフォルト値: Empty。登録されたメディアアセットをカスタム検索ライブラリにインポートする場合は、このフィールドを指定する必要があります。詳細については、「OpenAPI に基づくカスタム検索ライブラリの使用プロセス」をご参照ください。

    SearchLibName

    String

    いいえ

    編集および制作後に自動的に登録されるメディアファイルをカスタム検索ライブラリにインポートする場合は、このフィールドを指定する必要があります。

    詳細については、「OpenAPI に基づくカスタム検索ライブラリの使用プロセス」をご参照ください。

    NeedSnapshot

    Boolean

    いいえ

    メディアファイルのスナップショットを自動的にキャプチャするかどうかを指定します。デフォルト値: true。

    NeedSprite

    Boolean

    いいえ

    スナップショットを使用してメディアファイルのスプライトを生成するかどうかを指定します。デフォルト値: true。

    PipelineId

    String

    いいえ

    カスタムパイプラインの ID。必要に応じてこのフィールドを指定できます。複数の事業部門が同じ Alibaba Cloud アカウントを使用してタスクを送信する場合、このフィールドを使用して異なる事業部門のタスクを区別できます。要件がある場合は、チケットを送信してください。

    MaxBitrate

    Integer

    いいえ

    出力ビデオの最大ビットレート。必要に応じてこのフィールドを指定できます。このフィールドを指定し、入力ビデオのビットレートがこのフィールドの値より大きい場合、システムはこのフィールドの値を出力ビデオのビットレートとして使用します。

    このフィールドを指定しない場合、出力ビデオの最大ビットレートはデフォルトで 5,000 です。

    KeepOriginMaxBitrate

    Boolean

    いいえ

    出力ビデオにソースファイルの最大ビットレートを使用するかどうかを指定します。デフォルト値: false。このフィールドを true に設定すると、システムは出力ビデオにソースファイルの最大ビットレートを使用します。出力ビデオの最大ビットレートは 50,000 です。

    KeepOriginVideoMaxFps

    Boolean

    いいえ

    出力ビデオにソースファイルの最大フレームレートを使用するかどうかを指定します。デフォルト値: false。このフィールドを true に設定すると、システムは出力ビデオにソースファイルの最大フレームレートを使用します。

    例

    {
	"AutoRegisterInputVodMedia": true,
	"OutputWebmTransparentChannel": true,
	"CoverConfig": {
		"StartTime": 3.3
	},
	"AudioChannelCopy": "left",
	"PipelineId": "xxxd54a97cff4108b555b01166d4bxxx",
	"MaxBitrate": 5000,
	"KeepOriginMaxBitrate": false,
	"KeepOriginVideoMaxFps": false
}

    MediaMetadata

    編集後に生成されたメディアファイルのメタデータ。値は JSON 形式である必要があります。

    パラメーター

    パラメーター

    タイプ

    必須

    説明

    Title

    String

    いいえ

    メディアファイルのタイトル。

    • タイトルは最大 128 バイトの長さにすることができます。

    • タイトルは UTF-8 でエンコードする必要があります。

    Description

    String

    いいえ

    メディアファイルの説明。

    • 説明は最大 1,024 バイトの長さにすることができます。

    • UTF-8 エンコーディング。

    Tags

    String

    いいえ

    メディアファイルのタグ。

    • 最大 16 個のタグを指定できます。

    • 複数のタグはカンマ (,) で区切ります。

    • 各タグは最大 32 バイトの長さにすることができます。

    • 値は UTF-8 でエンコードする必要があります。

    CateId

    Long

    いいえ

    メディアファイルのカテゴリ ID。

    CustomMetadata

    String

    いいえ

    JSON 形式のカスタムメタデータ。

    例:

    {"key1": "value1", "dict1": {"key2": "value2", "key3": "value3"}}

    出力ビデオのメタデータには、上記の情報が含まれます。

    UserData

    JSON 形式のユーザーデータ。制作タスクを送信するときに、UserData パラメーターにユーザーデータを追加できます。制作タスクのコールバック URL を設定すると、制作完了後にシステムがその URL にコールバックリクエストを送信し、コールバックリクエストには UserData パラメーターが含まれます。このパラメーターの値は、最大 1,024 バイトの長さにすることができます。

    使いやすくするために、UserData パラメーターで直接コールバックを設定できます。詳細については、「制作完了後にコールバックを受信するためのイベント通知アドレスの設定」をご参照ください。

    次の表に、UserData パラメーターで予約されているフィールドを示します。

    予約済みパラメーター

    パラメーター

    タイプ

    必須

    説明

    NotifyAddress

    String

    いいえ

    コールバック URL。HTTP コールバックと Alibaba Cloud Message Service (MNS) コールバックがサポートされています。

    HTTP コールバックのサンプル: http://yourdomain.com/callback。

    MNS コールバックのサンプル: "ice-callback-test"。MNS キューの名前は ice-callback で始まる必要があります。