請求に /meta/ read の料金が含まれるのはなぜですか?
毎月の請求に /meta/read の料金が含まれるのは、Transloadit がデフォルトで、アップロードされたファイルや他の Step が生成したファイルからメタデータを自動抽出するためです。これは標準的なファイル処理の一部で、Assembly Instructions での
${file.meta.width}、${file.meta.duration} などの抽出済みメタデータ変数の利用を支えています。
/meta/read の料金はいくらですか?
標準のメタデータ抽出では、アップロードされたファイルと追跡対象の各 Step の出力について、ファイルサイズの 1% が課金対象の処理バイト数として計上されます。1 回の抽出では、次のようになります。
- 100 MB のファイルでは、1 MB 分のメタデータ抽出料金が発生します
- 1 GB のファイルでは、10 MB 分のメタデータ抽出料金が発生します
オプションの、より高コストなメタデータには追加料金が発生する場合があります。詳しくは、Robot ドキュメントの
output_meta パラメーターをご覧ください。
/meta/read の料金を回避するにはどうすればよいですか?
アップロード用の Step を含め、出力からメタデータを抽出する必要のない各
Step に "output_meta": false を追加すると、メタデータの自動抽出を無効にできます。
{
"steps": {
":original": {
"robot": "/upload/handle",
"output_meta": false
},
"resize": {
"use": ":original",
"robot": "/image/resize",
"format": "jpg",
"width": 200,
"height": 200,
"output_meta": false
}
}
}
メタデータ抽出を有効にしておくべきなのはどのような場合ですか?
多くの処理用 Template では、メタデータ抽出が必要です。次の用途で重要な役割を果たします。
- Robot に、処理できないファイル形式を無視させる
- Assembly Instructions で抽出済みのファイルメタデータ変数を使用する(
${file.meta.width}や${file.meta.duration}など) - メタデータのプロパティに基づいてファイルをフィルタリングする
- メタデータタグをファイルとともに保存する
- 抽出したメタデータに基づいて動的なファイルパスを生成する
${file.id} や ${file.name} などのファイル識別子や名前は、メタデータを抽出しなくても利用できます。たとえば、次の Template はメタデータを抽出せずに、アップロードされたファイルの名前を使用します。
{
"steps": {
":original": {
"robot": "/upload/handle",
"output_meta": false
},
"stored": {
"use": ":original",
"robot": "/s3/store",
"path": "/uploads/${file.id}_${file.name}",
"output_meta": false
}
}
}
メタデータ抽出を無効にしても問題ないのはどのような場合ですか?
次の条件を満たす場合は、メタデータ抽出を無効にできます。
- 後続の Step で、抽出済みの
file.meta.*変数を使用しない - パスや名前に、固定値、指定されたフィールド、またはファイルの識別子や名前を使用する
- 抽出したメタデータに基づいてファイルをフィルタリングしたり並べ替えたりする必要がない
メタデータが不要な単一のアップロードファイルの例です(fields は
Assembly の作成時に指定します)。
{
"steps": {
"uploaded": {
"robot": "/upload/handle",
"output_meta": false
},
"exported": {
"use": "uploaded",
"robot": "/s3/store",
"path": "${fields.output_path}",
"output_meta": false
}
}
}