Ops Parameter Format
最終更新日：2025-08-18 15:32:56
音声および動画の処理操作は、音视频转码、音视频拼接、视频截图、およびアルバムアートの取得の4つの主要カテゴリのパラメータを含みます。各カテゴリの具体的なパラメータは以下に詳述されています。
1. 音视频转码（avthumb）
例: ソースファイルをFLV形式に変換し、音声ビットレートを64k、動画ビットレートを128kに設定します。
avthumb/flv/ab/64k/vb/128k|saveas/YnVja2V0OmtleQ==
| パラメーター | 必須 | 説明 |
|---|---|---|
<op> |
必須 | avthumb（操作タイプ：オーディオ/ビデオ処理） |
<format> |
必須 | 出力ターゲットフォーマット。対応フォーマットには mp4、flv、m3u8、mpd などが含まれます。 |
オーディオトランスコーディングパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/acodec/<AudioCodec> |
いいえ | オーディオコーデック。サポートされているコーデック：libmp3lame、libfaac、libvorbis、libfdk_aac、opus など。また、元のオーディオコーデックを保持するための copy パラメーターもサポートしています。 |
/ab/<BitRate> |
いいえ | オーディオビットレート（単位：bit/s）。一般的な値：64k、128k、192k、256k、320k など。 |
/ar/<SamplingRate> |
いいえ | オーディオのサンプリングレート（単位：Hz）。一般的な値：8000、12050、22050、44100 など。注意：FLVフォーマットは44100、22050、11025のみサポートしています。 |
/aq/<AudioQuality> |
いいえ | オーディオ品質。MP3の場合、範囲：0〜9（値が小さいほど高品質）。AACの場合、範囲：10〜500（値が大きいほど高品質）。MP3およびAACのみ対応。/ab/と同時使用はできません。 |
/ac/<AC> |
いいえ | オーディオチャンネル数。1はモノラル、2はステレオです。 |
/aprofile/<AudioProfile> |
いいえ | オーディオ圧縮プロファイル。libfaac の場合：aac_main、aac_low。libfdk_aac の場合：aac_low、aac_he、aac_he_v2。デフォルト：aac_lc。 |
/volume/<volumeadjustment> |
いいえ | オーディオ音量の調整。係数またはデシベル（dB）での調整をサポート： - 係数：範囲は0～2（0は無音、1は元の音量、2は2倍、1.5は1.5倍）。 - デシベル：推奨範囲は-10dB～10dB。負の値で音量が下がり、正の値で上がります。過度な値は音の歪みを引き起こす可能性があります。 |
/loudnorm/<VolumeNormalization> |
いいえ | ラウドネスノーマライゼーションターゲットを設定（単位：LUFS）。範囲：-70～-5。数値が大きいほど（マイナスが小さいほど）音量が大きくなります。 注意： - 出力オーディオコーデックが eac3 の場合、/ar/ は48000、44100、32000である必要があります。- 出力オーディオコーデックが ac3 の場合、/ar/ は48000または44100である必要があります。- DTSエンコーディングはサポートされていません。 - /volume/との同時使用は避けてください。 |
/write_id3v2/<write_id3v2> |
いいえ | AACトランスコーディング時に、ソースのID3v2フレームを書き込むかどうか。1で書き込み、0または未指定でスキップします。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | トランスコードされた出力を指定ファイルに保存します。値は bucket:key 形式の文字列をURLセーフBase64でエンコードしたものです。 |
ビデオトランスコーディングパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/vcodec/<VideoCodec> |
いいえ | ビデオコーデック。対応コーデック：libx264、libws265（H.265/HEVC）、libvpx、libtheora、libxvid など。copyを指定すると元のビデオコーデックを保持します。注意: /vcodec/ で解像度を指定した場合は /vb/（ビットレート）の設定が必要です。設定しない場合は元のエンコードが適用されます。 |
/s/<Resolution> |
いいえ | ビデオの解像度を 幅x高さ （例：640x480）または適応モードで設定します：- 幅と高さの両方を設定：正確なサイズにスケールされます。アスペクト比が異なる場合、画像が引き伸ばされたり圧縮されたりすることがあります。 - 幅または高さのみを設定（例： 1280x-1、-1x720）：他方のサイズはアスペクト比を維持するよう自動調整されます。 |
/autoscale/<Autoscale> |
いいえ | /s/と組み合わせて使用します。1でアスペクト比を維持したまま、ビデオが/s/の矩形内に収まるよう調整します（比率が異なる場合は黒縁が現れることがあります）。0またはデフォルトはストレッチしてフィットさせます。 |
/autofill/<Autofill> |
いいえ | /s/と組み合わせて使用します。1を指定するとアスペクト比を維持し、中心に配置して余白を黒帯で埋めます。0またはデフォルトの場合はストレッチして全体にフィットさせます。例：ソース1920x1920、ターゲット /s/1280x720。- autofill=1：実際のビデオコンテンツ720x720が1280x720の中央に配置され、黒帯が追加されます。 |
/sar/<Sar> |
いいえ | ピクセルアスペクト比（例：1:1）。解像度より優先されます。例： /s/720x720と/sar/1:2の組み合わせで出力は720x1440になります。 |
/vb/<VideoBitRate> |
いいえ | ビデオビットレート（bit/s単位）、例：128k, 1.25m, 5m。 |
/vbRatio/<vbRatio> |
いいえ | 出力ビデオのビットレートは入力ビットレートにこの係数を掛けた値になります。範囲：(0, 15]。 注意： - 0または15を超える値は失敗します。 - 結果が50Mbpsを超える場合はこのパラメータは無視されます。 - /vb/と/vbRatio/の両方が指定された場合、/vbRatio/が優先されます。 |
/r/<FrameRate> |
いいえ | ビデオのフレームレート（Hz）、一般的な値は24、25、30です。デフォルトはソースの値です。 |
/calcMD5/<calcMD5> |
いいえ | 1でヘッダーにMD5ハッシュを付加します（MP4のみ対象）。0（デフォルト）は無効。 |
/calcFrameRate/<calcFrameRate> |
いいえ | 1を指定すると手動計算およびframe_rateの付与を有効にします（FLVのフレームレートが変化する場合に有効）。 |
/lowfps_check/<lowfps_check> |
いいえ | 1にすると低フレームレートのソースビデオのサポートを有効化します。入力FPSが10未満の場合、出力は10fpsに設定されます。デフォルトは0です。 |
/force_key_frames/<force_key_frames> |
いいえ | 指定したタイムスタンプ（秒）でキーフレームを挿入します。例：1.1,2.3,4.2。値はソートされ、カンマ区切りの小数値でなければなりません。 |
/rotate/<Degree> |
いいえ | 時計回り回転角度：90、180、270、auto。デフォルトは回転なし。 |
/vprofile/<VideoProfile> |
いいえ | ビデオ圧縮プロファイル：baseline、main、high、high10、high422、high444。高いプロファイルほど高機能な圧縮を実現します。 |
/pix_fmt/<PixelFormat> |
いいえ | ピクセルフォーマットを設定します。例：yuv420p、yuv422p、yuv444p。yuv420p（YUV 4:2:0）はWeb動画配信で最も一般的で、互換性と圧縮効率に優れています。 |
/level/<BitTorrentLevel> |
いいえ | H.264のレベル。範囲：1.0～5.1。互換性のための設定（libx264有効時のみ）。 |
/crf/<CRF> |
いいえ | 品質制御のためのConstant Rate Factor（libx264有効）。範囲：0～51。値が大きいほど画質は低下します。推奨値：[18, 28]。ご注意： 最適な品質・ビットレート管理のため、 /maxrate/、/crf/、/bufsize/を同時に設定することを推奨します。 |
/maxrate/<Maxrate> |
いいえ | VBRエンコード時の最大ビットレート（例：1000k）。/bufsize/との併用が必須です。 |
/bufsize/<Bufsize> |
いいえ | デコーダバッファサイズ。/maxrate/と組み合わせて使用します（例：1000k）。 |
/dup_lastframe_sec/<dup_lastframe_sec> |
いいえ | 最終フレームを延長する秒数。例：/dup_lastframe_sec/15はラストフレームを15秒間表示します。 |
/GOPInterval/<GOPInterval> |
いいえ | キーフレーム間隔（ミリ秒単位）。未設定の場合はインテリジェントアルゴリズムで自動設定されます。g（単位:フレーム）との併用はできません。 |
/StrictGOPInterval/<StrictGOPInterval> |
いいえ | キーフレーム間隔（ms）の厳密な固定。 - < 0はエラーです。- > 0は指定した間隔を強制します。- = 0は全フレームをIフレームにします。この設定は、 /GOPInterval/と-gよりも優先されます（同時指定時）。 |
/deinterlace/<Deinterlace> |
いいえ | デインターレース設定: - 0: デインターレースなし（デフォルト、常にプログレッシブ出力）。- 1: アグレッシブ。常に適用。- 2: 標準。入力がインターレースの場合のみ適用。- 3: 高度（FFmpeg内部）。インターレース入力時のみ適用。 |
/stripmeta/<StripMeta> |
いいえ | 1でファイルのメタデータを削除し、0で保持します。 |
/seiKeep/<seiKeep> |
いいえ | 1はライブストリーミングトランスコーディング中にSEIメッセージを保持し、0（デフォルト）は保持しません。リマックス時は常にSEIが保持されます。 |
/delogo/<x:y:w:h,x:y:w:h...> |
いいえ | 指定した矩形範囲にぼかしを適用します（ロゴ除去用）。フォーマット：x:y:w:h。複数範囲はカンマで区切ります。 |
/reverse/<reverse> |
いいえ | 1で再生を逆順にし、0（デフォルト）は通常再生です。逆再生する音声・動画は5分未満である必要があります。 |
/speedup/<speedup> |
いいえ | 再生速度を調整します。スロー時の範囲：[0.1,1)、ファスト時の範囲：(1,10]。値1は通常速度です。小数値も指定可能です。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | トランスコードされた出力を指定ファイルに保存します。URLセーフBase64エンコード方式です。 |
リマックス & オーディオ/ビデオセグメンテーションパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
/pat_period/<pat_period> |
いいえ | PAT/PMTインターバルを秒単位で設定します。小数点（例：0.23, 5.6）もサポートします。 |
/pcr_every_packet/<pcr_every_packet> |
いいえ | 1 の場合、pcr_packet_period が 1 となり、全てのパケットにPCRが含まれます。デフォルトは無効です。 |
/rename_by_key/<RenameByM3U8> |
いいえ | 1 の場合、セグメント名にプライマリM3U8のファイル名を使用します。0（デフォルト）は無効。avconcatとavthumbのM3U8出力に有効です。 |
/pes_payload_size/<pes_payload_size> |
いいえ | 最小PESペイロードサイズを設定します。0 を設定すると、パケットごとに1つのAACフレームとなります。デフォルト：無効。 |
/dash_hls_playlist/<dash_hls_playlist> |
いいえ | 1 を設定すると、MPDと同時にM3U8ファイルも出力されます。デフォルトは 0 （MPDのみ）。フォーマットが mpd の場合のみ有効です。 |
/enable_mp4_hvc1/<enable_mp4_hvc1> |
いいえ | H.265ビデオ用。1 の場合、ビデオトラック内の stsd タグを hvc1 に設定します（デフォルト：hev1）。デフォルトは無効です。 |
/segtype/<segtype> |
いいえ | DASH用のセグメント形式：mp4 または m4s。デフォルト：m4s。 |
/segtime/<SegSeconds> |
いいえ | セグメントの長さ（秒）。整数：1～120。 デフォルト動作： - 入力がM3U8/MPDでない場合：10秒。 - 入力がM3U8/MPDでトランスコーディングなし：インデックスのみ処理。 - 入力がM3U8/MPDでトランスコーディングあり：自動計算。 |
/fastStartSeg/<FastStartSeg> |
いいえ | 最初のM個のセグメント期間を設定します。形式：MxNs（例：5x3sは最初の5セグメントが各3秒）。 |
/map/<map> |
いいえ | 入力ストリームのマッピング： - map=0: すべてのストリーム- map=0:a: すべてのオーディオストリーム- map=0:a:0: 最初のオーディオ- map=0:a:lang=chi: 言語ラベル。 |
/an/<AudioNo> |
いいえ | 1でオーディオストリームを削除し、0で保持します（デフォルト）。 |
/vn/<VideoNo> |
いいえ | 1でビデオストリームを削除し、0で保持します（デフォルト）。 |
/moovToFront/<MoovToFront> |
いいえ | 1でMP4のmoovアトムをファイルの先頭に移動し、0では移動しません。 |
/stripmeta/<StripMeta> |
いいえ | 1でファイルのメタデータを削除し、0で保持します（デフォルト）。 |
/preset/<Preset> |
いいえ | HLSプリセット名。下記の表を参照してください。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 出力ファイルを保存します。URLセーフなBase64エンコード。 |
/preset/ における HLS プリセット：
| カテゴリ | プリセット名 | 説明 |
|---|---|---|
| オーディオ | audio_32k | 32k ビットレートのオーディオ |
| audio_48k | 48k ビットレートのオーディオ | |
| audio_64k | 64k ビットレートのオーディオ | |
| ビデオ | video_16x9_150k | 150K ビットレート、16:9、400x224 解像度 |
| video_16x9_240k | 240K ビットレート、16:9、400x224 解像度 | |
| video_16x9_440k | 440Kビットレート、16:9、400x224解像度 | |
| video_16x9_640k | 640Kビットレート、16:9、400x224解像度 | |
| video_4x3_150k | 150Kビットレート、4:3、400x300解像度 | |
| video_4x3_240k | 240Kビットレート、4:3、400x300解像度 | |
| video_4x3_440k | 440Kビットレート、4:3、400x300解像度 | |
| video_4x3_640k | 640Kビットレート、4:3、400x300解像度 | |
| video_150k | 150Kビットレート、ソースのアスペクト比を維持 | |
| video_240k | 240Kビットレート、ソースのアスペクト比を維持 | |
| video_440k | 440Kビットレート、ソースのアスペクト比を維持 | |
| video_640k | 640Kビットレート、ソースのアスペクト比を維持 | |
| video_1000k | 1000Kビットレート、ソースのアスペクト比を保持 | |
| video_1500k | 1500Kビットレート、ソースのアスペクト比を保持 |
HLS/DASH 可変ビットレートパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/envBandWidth/<EnvBandWidth> |
いいえ | M3U8ストリーム切替用の帯域幅しきい値（単位：b/s）。コロン区切り。範囲：[2,10]個の値。各値：(50000, 30000000]。例：60000:150000:500000。**/multiAb/・/multiVb/などと値の数を一致させる必要があります。**DASHでは無効です。 |
/multiAb/<MultiAb> |
いいえ | 複数のオーディオビットレートをコロン区切りで指定します。例：64k:128k:256k。値の範囲：[2,10]。/ab/との併用はできません。M3U8シナリオでは個数を一致させてください。 |
/multiVb/<MultiVb> |
いいえ | 複数のビデオビットレートをコロン区切りで指定します。例：128k:600k:1.25m。/vb/との併用はできません。M3U8の場合、数値の個数が一致している必要があります。 |
/multiResolution/<MultiResolution> |
いいえ | 複数のビデオ解像度をコロン区切りで指定します（例：320x240:640x480:1080x720）。/s/との併用はできません。ax-1 または -1xa を利用してアダプティブスケーリングも可能です。M3U8の場合、数値の個数が一致している必要があります。 |
/dash_hls_playlist/<dash_hls_playlist> |
いいえ | 1を指定すると、MPDに加えてM3U8ファイルも生成され、アダプティブビットレートに対応可能となります。デフォルトは0です。出力フォーマットがmpdの場合のみ適用されます。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | トランスコード後の出力を保存します。URL安全なBase64でエンコードされています。 |
動画クリッピングパラメーター
| パラメータ | 必須 | 説明 |
|---|---|---|
/ss/<SeekStart> |
いいえ | 動画セグメント抽出の開始時間（秒）。 |
/t/<Duration> |
いいえ | 抽出される動画セグメントの継続時間（秒）。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | クロップ後の出力を保存します。URLセーフなBase64でエンコードされています。 |
動画クロップパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/vcrop/<Vcrop> |
いいえ | 動画トリミングのサイズ（寸法）およびオフセットを設定します。デフォルトはトリミングなしです。詳細は下記セクションを参照ください。 |
/gravity/<Gravity> |
いいえ | トリミングのanchor/origin（基準点）を設定します。デフォルトはTOP_LEFTです。詳細は下記オプションをご確認ください。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | トリミング後の出力を、URLセーフなBase64形式で保存します。 |
/vcrop/用 動画トリミング操作値：
| 形式 | 説明 |
|---|---|
<Width>x |
幅を設定します。高さは変更されません（幅：0～10000）。 |
!{vcropSize}a<dx>a<dy> |
アンカーから右方向にdx、下方向にdyだけオフセットします（詳細はオリジナルシステムでご確認ください）。 |
x<Height> |
高さを設定します。幅は変更されません（高さ：0～10000）。 |
<Width>x<Height> |
幅と高さを明示的に設定します（0～10000）。 |
「/gravity/」のオプション一覧：
| 値 | 説明 |
|---|---|
TOP_LEFT |
原点は左上です。Xは左から右、Yは上から下の方向になります。 |
TOP_CENTER |
原点は上中央。X：左→右、Y：上→下。 |
TOP_RIGHT |
原点は右上。X：右→左、Y：上→下。 |
CENTER_LEFT |
原点は左中央。X：左→右、Y：上→下。 |
CENTER |
原点は中央。X：左→右、Y：上→下。 |
CENTER_RIGHT |
原点は右中央。X：右→左、Y：上→下。 |
BOTTOM_LEFT |
原点は左下。X：左→右、Y：下→上。 |
BOTTOM_CENTER |
原点は下中央。X：左→右、Y：下→上。 |
BOTTOM_RIGHT |
原点は右下。X：右→左、Y：下→上。 |
字幕パラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/subtitle/<EncodedPath1[,EncodedPath2...]> |
はい | 字幕ファイル。それぞれのパスはURLセーフなBase64文字列です。複数ファイルの場合はカンマで区切ります。SRT、組み込みMKV、または embed オプションがサポートされます。 |
/subtitleType/<subtitleType> |
いいえ | 1はソフト字幕、2はハード字幕、0（デフォルト）は自動検出です。 |
/subtitleAttr/<EncodedAttr1[,EncodedAttr2...]> |
いいえ | 複数ビットレートのM3U8でVTTに対応する字幕属性です。形式：base64_encode(lang=xx1,name=yy1),base64_encode(lang=xx2,name=yy2)。数は字幕ファイル数に一致する必要があります。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 字幕を埋め込んだり添付したりして出力を保存します。URLセーフなBase64でエンコードされます。 |
透かしパラメータ（画像・動画透かし）
| パラメータ | 必須 | 説明 |
|---|---|---|
/wmImage2/<EncodedPath1[,EncodedPath2...]> |
いいえ | 画像・動画透かしパス（URLセーフなBase64でエンコードし、カンマで区切る）。 |
/wmGravity/<Gravity1[,Gravity2...]> |
いいえ | 透かしの位置を設定します。/gravity/ と同じオプションを使用できます。複数指定する場合はカンマで区切ります。 |
/wmauto/<wmauto> |
いいえ | 1の場合、透かしは動画解像度に合わせてスケールされます。それ以外の場合は元のサイズを使用します。 |
/wmWidth/<WmWidth1[,WmWidth2...]> |
いいえ | 透かしの幅（pxまたはパーセンテージで指定、例：40 または 50%）。0または負の値の場合、その次元で自動サイズ調整を行います。 |
/wmHeight/<WmHeight1[,WmHeight2...]> |
いいえ | 透かしの高さ。/wmWidth/と同じオプションが使用可能です。 |
/wmDissolve/<alpha1[,alpha2...]> |
いいえ | 透かしの不透明度。範囲は[0,100]。デフォルト：100（不透明）。 |
/wmdx/<dx1[,dx2...]> |
いいえ | 基点からの水平オフセット（px）。正の値：右、負の値：左。/wmGravity/の数と一致する必要があります。 |
/wmdy/<dy1[,dy2...]> |
いいえ | 基点からの垂直オフセット（px）。正の値：下、負の値：上。/wmGravity/の数と一致する必要があります。 |
/wmInterval/<wmInterval> |
いいえ | 透かし切り替えの時間間隔（秒単位）。 |
透かしパラメータ（テキスト透かし）
| パラメーター | 必須 | 説明 |
|---|---|---|
/wmText/<EncodedText1[,EncodedText2...]> |
いいえ | 透かしテキスト（複数可）。それぞれURLセーフBase64でエンコードします。テキスト内のカンマにも対応。中国語はUTF-8でエンコードしてください。 |
/wmFont/<EncodedFontNames> |
いいえ | フォント名（複数可）。カンマ区切り後にURLセーフBase64でエンコードしてください。半角英数字、スペース、ハイフンのみ使用可能です。 |
/wmFontColor/<EncodedColors> |
いいえ | フォントカラー（複数可）。カンマ区切り後、URLセーフBase64でエンコードしてください。フォーマット：0xRRGGBB、&HRRGGBBまたは16進。デフォルト値：0xffffff。 |
/wmFontSize/<size1[,size2...]> |
いいえ | フォントサイズ（複数可）。整数または高さに対するパーセンテージ（例：10または10%）。ピクセル： [5,2160]、パーセント：(0,100%]。デフォルトは6%です。 |
/wmFontDissolve/<alpha1[,alpha2...]> |
いいえ | 不透明度。範囲は[0,100]、デフォルトは100です。 |
/wmFontBorderWidth/<w1[,w2...]> |
いいえ | フォントの縁取り幅。整数値。<=0で縁取りなし（デフォルトは0）。 |
/wmFontBorderColor/<EncodedBorderColors> |
いいえ | 縁取りのカラー。/wmFontColor/と同様にエンコードします。デフォルト値：0x000000。 |
/wmTextGravity/<gravity1[,gravity2...]> |
いいえ | テキスト透かしの位置指定。/wmGravity/と同じです。デフォルトはtop_right。 |
/wmtextdx/<dx1[,dx2...]> |
いいえ | テキストアンカーからの水平方向のオフセット（px、デフォルト値：0）。 |
/wmtextdy/<dy1[,dy2...]> |
いいえ | テキストアンカーからの垂直方向のオフセット（px、デフォルト値：0）。 |
/wmTextInterval/<interval1[,interval2...]> |
いいえ | テキスト透かしの切り替え間隔（秒、1以上）。 |
/wmFontBold/<b1[,b2...]> |
いいえ | 0以外の値でフォントを太字にします（デフォルトは0）。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 透かし入り出力を保存します。URLセーフなBase64エンコードとなります。 |
LBHDパラメータ
| パラメーター | 必須 | 説明 |
|---|---|---|
/nbhd/<nbhd> |
いいえ | 1でAI強化によるインテリジェント高画質エンコーディングを有効化、0で無効化（デフォルト）。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 出力結果をURLセーフなBase64形式で保存します。 |
HLS標準暗号化パラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
/hlsKey/<HlsKey> |
いいえ | AES-128暗号化キー。OAEPでRSA暗号化され、ASCIIの16進表現後にURLセーフBase64エンコードされている必要があります。 |
/hlsKeyUrl/<HlsKeyUrl> |
いいえ | HLSキー取得用URL。URLセーフBase64でエンコードし、M3U8の#EXT-X-KEYタグに挿入します。 |
/hlskeygen/<hlskeygen> |
いいえ | キーファイル生成／アップロードは 1、生成しない場合は 0（デフォルト）。 |
/hlssk/<hlssk> |
いいえ | RSA秘密鍵ファイル（PEM形式）、URLセーフBase64エンコード済み。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 暗号化された出力を保存し、URLセーフBase64でエンコードされます。 |
2. 音声・動画連結（avconcat）
例: fileA、fileB、fileCを連結して、1つのFLVファイルにします。
avconcat/flv/ZmlsZUE=/ZmlsZUI=/ZmlsZUM=|saveas/YnVja2V0OmtleQ==
ZmlsZUE=, ZmlsZUI=, ZmlsZUM=は、それぞれfileA、fileB、fileCのbucket:keyをURLセーフなBase64形式でエンコードしたものです。
| パラメータ | 必須 | 説明 |
|---|---|---|
<op> |
必須 | avconcat（操作種別：音声/動画連結） |
<format> |
必須 | 出力の対象フォーマット（例：mp4, flv, m3u8） |
/<EncodedUrl1>/<EncodedUrl2>/.../<EncodedUrlN> |
必須 | 連結するファイル。URLセーフなBase64でエンコードしてください。全てのファイルは同一バケットに保存されている必要があります。最大：5ファイル。 注: トランスコーディングパラメータと併用できます。 |
|saveas/<Encode(bucket:filekey)> |
任意 | 出力をファイルとして保存します。URLセーフなBase64でエンコードしてください。 |
3. 動画スクリーンショット（vframe）
例: 10秒目のスクリーンショットを取得し、JPGファイルとして保存します。
vframe/jpg/offset/10|saveas/YnVja2V0OmtleQ==
| パラメータ | 必須 | 説明 |
|---|---|---|
<op> |
はい | vframe（操作種別：ビデオスクリーンショット） |
<format> |
はい | 出力画像フォーマット：jpg、png、gif、webp など |
/mode/<mode> |
いいえ | サムネイルのリサイズ： - 1: 横幅／高さが最小指定値以上、中央をスケール・切り抜き。- 2: 最大指定サイズ以内、アスペクト比を維持して縮小。- 3: 最小指定サイズ以上、スケールのみ（アスペクト比維持のため超過の場合あり）。 |
/offset/<Second> |
はい* | 指定秒数にキャプチャ。複数キャプチャ（/interval/、/offsets/、/vframeN/）未使用の場合に必須。フォーマットが gifかつ/t/と併用時、GIFの開始時刻を指定。 |
/offsets/<vframeList> |
いいえ | 指定した秒数ごとに複数のスクリーンショットを取得。コロン区切り（例：1:3:10:20）。出力は画像のZIPファイル。 |
/interval/<Interval> |
いいえ | 指定した間隔（秒）ごとにスクリーンショットを取得。出力はZIP形式。 |
/vframeN/<vframeN> |
いいえ | スクリーンショットの枚数。出力はZIP形式。 |
/w/<width> |
いいえ | ピクセル単位の幅（1〜1920）。 |
/h/<height> |
いいえ | ピクセル単位の高さ（1〜1080）。 |
/autofill/<autofill> |
いいえ | /w/ および /h/ と組み合わせて使用。1でアスペクト比維持＋黒枠追加。/mode/とは併用不可。幅と高さの両方が必須。 |
/isZip/<isZip> |
いいえ | 複数スクリーンショットのZIP出力（デフォルトは圧縮）。0で無効化。 |
/sprite/<sprite> |
いいえ | スプライトシートのサイズ例：4x5。/interval/必須。スプライト画像または複数フレームの場合は複数イメージで出力。 |
/rotate/<degree> |
いいえ | 時計回り回転指定：90、180、270、auto。デフォルトは回転なし。 |
/reverse/<reverse> |
いいえ | 1はフレーム順序を反転（GIF用）、0は通常。 |
/t/<Duration> |
いいえ | GIFキャプチャの継続時間（デフォルト：5s）。 |
/r/<FrameRate> |
いいえ | GIFのフレームレート（デフォルト：ソース）。 |
/gif_interval/<Gif_interval> |
いいえ | GIFループ間隔（デフォルト：2s）。 |
/speedup/<speedup> |
いいえ | 再生速度。<1は低速、>1は高速。 |
|saveas/<Encode(bucket:filekey)> |
いいえ | 出力画像またはZIPを保存、URL安全なBase64エンコード。 |
4. アルバムアート取得（getapic）
例: オーディオファイルからアルバムアートを取得し、JPGとして保存します。
getapic/jpg|saveas/YnVja2V0OmtleQ==
| パラメータ | 必須 | 説明 |
|---|---|---|
<op> |
必須 | getapic（オペレーションタイプ：MP3アルバムアート取得） |
<format> |
はい | 出力画像フォーマット: jpg、png など |
|saveas/<Encode(bucket:filekey)> |
いいえ | 抽出した画像を保存し、URLセーフなBase64でエンコードします。 |
付録
1. サポートされているフォント形式
| フォントファミリー | パラメーター値（フォント名） | 著作権情報 |
|---|---|---|
| Noto Sans CJK SC | Noto Sans CJK SC Regular | これはお客様のプラットフォームの法務セクションに追加できます。内容例： — Video Watermarkなどの機能において、Noto Sans SCおよびNoto Serifフォントの著作権者はGoogleです。利用はOFL（SIL Open Font License）に基づいて許可されています。OFLの全文は下記でご確認いただけます：https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL |
| Noto Sans CJK SC Black | （同上） | |
| Noto Sans CJK SC Bold | （同上） | |
| Noto Sans CJK SC DemiLight | （同上） | |
| Noto Sans CJK SC Light | （同上） | |
| Noto Sans CJK SC Medium | （同上） | |
| Noto Sans CJK SC Thin | （同上） | |
| Noto Sans Mono CJK SC | Noto Sans Mono CJK SC Regular | （同上） |
| Noto Sans Mono CJK SC Bold | （同上） | |
| Noto Serif CJK SC | Noto Serif CJK SC | （上記と同様） |
| Noto Serif CJK SC Black | （上記と同様） | |
| Noto Serif CJK SC ExtraLight | （上記と同様） | |
| Noto Serif CJK SC Light | （上記と同様） | |
| Noto Serif CJK SC Medium | （上記と同様） | |
| Noto Serif CJK SC SemiBold | （上記と同様） | |
| Roboto | Roboto | これはお客様のプラットフォームの法務セクションに追加できます。内容例： — Video Watermarkなどの機能について、Robotoフォントの著作権者はGoogleです。Apache License, Version 2.0のもとで利用が許諾されています。ライセンスの全文は次のURLからご覧いただけます：http://www.apache.org/licenses/LICENSE-2.0.txt |
| Roboto Condensed | （上記と同様） | |
| Roboto Condensed Light | （上記と同様） | |
| Roboto Black | （上記と同様） | |
| Roboto Light | （同上） | |
| Roboto Medium | （同上） | |
| Roboto Thin | （同上） | |
| 文泉驿等宽黑体 | 文泉驿等宽黑体 | これはお客様のプラットフォームの法的セクションに追加できます。内容例： — 動画透かしなどの機能について、文泉驿フォントの著作権者はFangQ氏および「文泉驿理事会」です。使用はGNU General Public License（GPL）の下で許諾されています。GPLの全文は次のURLからご覧いただけます: http://wenq.org/wqy2/index.cgi?GPL |
| 文泉驿正黑 Sharp | 文泉驿正黑 Sharp | （同上） |
| 文泉驿正黑 | 文泉驿正黑 | （同上） |
このドキュメントの内容は役に立ちましたか?
はい
いいえ