ウェブサーバーからのファイルのインポート
🤖/http/import はウェブ URL 経由で公開されている任意のファイルを Transloadit にインポートします。

この Robot の結果には、インポート元の URL を参照する import_url フィールドがメタデータに含まれます。このファイルを使用した後続の変換結果にも、この import_url フィールドが含まれます。これにより、変換結果を、使用した元のインポート URL と対応付けられます。
この Robot は、次のサービス上のファイルへのリンクを解釈できます。
- Dropbox
- Google Drive
- Google Docs
- OneDrive
ファイルをプレビューする HTML ページをダウンロードするのではなく、実際のファイル自体をインポートします。
使用例
指定した URL から画像をインポートします:
{
"steps": {
"imported": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/chameleon.jpg"
}
}
}パラメーター
interpolateboolean | Record<string, boolean>処理設定の各フィールドで Assembly Variables を展開するかどうかを制御します。
デフォルトでは、Robot の処理設定のほとんどのフィールドで Assembly Variables が展開されます。すべての設定フィールドをリテラルテキストとして扱うには、このパラメーターを
falseに設定してください。特定のフィールドだけをリテラルテキストとして扱うには、そのフィールドのパスをfalseに設定してください。デフォルトでリテラルとして扱われる Robot 固有のフィールドで展開を有効にするには、このパラメーターをtrueに設定するか、そのフィールドのパスをtrueに設定してください。pathのようなフィールド名を使用してください。ネストされたオブジェクトには、ffmpeg.vfのようなドット区切りのパスを使用してください。output_metaRecord<string, boolean> | boolean | Array<string>算出に多くの CPU リソースを要するメタデータを指定できます。Assembly の処理速度を維持するため、これらはデフォルトで無効になっています。
画像の場合、このオブジェクトに
"has_transparency": trueを追加すると、画像に透明な部分が含まれるかどうかを抽出できます。"dominant_colors": trueを追加すると、画像から 16 進数のカラーコードの配列を抽出できます。画像の場合、
"blurhash": trueを追加すると、画像のプレースホルダーをコンパクトに表す BlurHash 文字列も抽出できます。画像全体の読み込み中に、ぼかしたプレビューを表示するのに役立ちます。画像の場合、代わりに
"thumbhash": trueを使用すると、base64 エンコードされた ThumbHash をmeta.thumbhashに抽出し、meta.has_alpha(完全に不透明な場合も含め、アルファチャンネルが存在するかどうか)も抽出します。ThumbHash は EXIF の向きを反映したピクセルを表し、アニメーション画像では最初のフレームを使用します。抽出はベストエフォートです。40 メガピクセルを超える画像、非対応の形式、デコードの失敗やデコード処理の上限への到達があった場合、プレースホルダーは生成されません。抽出に成功すると、そのファイルのバイト数の 20% に相当するメタデータ料金が加算されます。無効な場合やハッシュが生成されない場合、ThumbHash の追加料金は発生しません。このオプションは画像を生成する Step に設定してください。たとえば、アップロードされた元画像では
/upload/handle、処理済みの出力では/image/resizeに設定します。/transloadit/storeにのみ設定しても、抽出は要求されません。ストレージは生成元のメタデータを保持します。Transloadit Storage は生成されたハッシュをその不変のバージョンとともに永続化し、保存済みの結果やネイティブのアセット読み取り時に返します。S3 への直接アップロードではプレースホルダーは生成されません。プレースホルダーには画像情報が含まれるため、画像全体と同じアクセス制御で保護してください。動画の場合、
"colorspace": trueパラメーターを追加すると、出力動画の色空間を抽出できます。動画の場合、
"interlaced": trueを追加すると、インターレース動画かどうかも検出できます。これは、低コストの ffprobe のfield_orderフラグと、ソースの先頭フレームに対する処理範囲を制限したidetサンプリング処理を組み合わせ、file.metaの下にinterlaced、field_order、診断用のinterlace_detectionオブジェクトを出力します。この処理は計算コストが高く、それに応じて課金されます。音声の場合、
"mean_volume": trueを追加すると、音声ファイルの平均音量を表す単一の値を取得できます。また、
falseに設定すると、メタデータの抽出をスキップしてトランスコードを高速化できます。user_metaRecord<string, any>(デフォルト:{})出力される各ファイルに、ファイルの内容を変更せずにカスタム JSON メタデータを追加します。ネストしたオブジェクトと配列に対応しています。
継承の動作は Robot によって異なります。値は出力ファイルの既存の
user_metaとマージされ、一致するトップレベルのキーは現在の Step によって置き換えられます。Robot が新しい出力を作成する場合は、必要なキーを明示的に割り当ててください。処理 Step では、
${file.*}は最初の入力を、${result.*}は出力されるファイルを参照します。値は Robot の実行後、後続のメタデータ抽出と一時保存の前に、出力ごとに評価されます。:originalでは、メタデータ抽出の前にアップロードごとに値が評価されます。後続の Step は
${file.user_meta.key}を読み取ります。完全な例と継承ルールについては、カスタムメタデータ を参照してください。resultboolean(デフォルト:false)この Step の結果を Assembly Status JSON に含めるかどうか
queuebatchqueue を 'batch' に設定すると、このステップのジョブの優先度を手動で下げ、キューの待ち時間がゼロである必要のないジョブが優先ジョブスロットを消費しないようにします。
force_acceptboolean(デフォルト:false)通常は無視するファイルタイプを Robot に強制的に受け入れさせます。
デフォルトでは、Robot は認識できないファイルを無視します。たとえば、🤖/video/encodeは入力画像を無視します。
force_acceptパラメーターをtrueに設定すると、Robot に渡されたすべてのファイルを強制的に受け入れさせることができます。通常、この設定はエラーにつながるため、デバッグやエッジケースへの対処にのみ使用してください。ignore_errorsboolean | Array<meta | import | execute>(デフォルト:[])処理の特定のフェーズでエラーを無視します。
このパラメーターを
["meta"]に設定すると、Robot はメタデータ抽出中のエラーを無視します。このパラメーターを
["execute"]に設定すると、Robot はメイン実行フェーズ中のエラーを無視します。このパラメーターを
["import"]に設定すると、Robot はソースファイルのインポート中のエラーを無視します。"import"フェーズは、インポート用の Robot でのみ利用できます。このパラメーターを
trueに設定すると、["meta", "import", "execute"]と同じ動作になり、3 つすべてのフェーズでエラーを無視します。force_namestring | Array<string> | null(デフォルト:null)インポートするファイルのカスタム名です。デフォルトでは、インポート元に基づいてファイル名が決まります。
import_on_errorsArray<meta>(デフォルト:[])["meta"]に設定すると、メタデータ抽出でエラーが発生してもファイルをインポートします。ignore_errorsも同様にエラーを無視して Robot の停止を防ぎますが、ファイルはインポートしません。url— 必須string | Array<string>インポートするファイルの取得元 URL です。
HTTPS URL では、Transloadit が信頼し、リクエスト先のホスト名と一致する有効な証明書を提示する必要があります。自己署名証明書、期限切れの証明書、ホスト名が一致しない証明書を使用すると、
HTTP_IMPORT_FAILUREが発生します。URL の配列、または
|で区切った URL の文字列を指定して、複数のファイルを一度にインポートすることもできます。その場合は、url_delimiterパラメーターも確認してください。区切り文字付きの URL リストは、変数の補間前に分割されます。変数によって挿入された区切り文字は、その URL の一部として扱われます。変数を通じて複数の URL を渡すには、
urlの値全体が補間によって URL の配列になるようにしてください。url_delimiterstring(デフォルト:"|")urlパラメーターの値に含まれる URL を分割する区切り文字を指定します。区切り文字はリテラルで指定する必要があります。インポートを分けるのは、元の
urlの値で補間式の外側にある区切り文字だけです。変数の値が分割されることはありません。headersArray<string> | Array<Record<string, string>> | string(デフォルト:[])ファイルのインポート時に送信するカスタムヘッダーです。
デフォルトは空の配列で、必要なヘッダー(Host など)以外に追加のヘッダーは送信されません。
ヘッダーは次の形式で指定できます。
- 「Header-Name: value」形式の文字列の配列
- ヘッダー名をキー、ヘッダー値を値とするオブジェクトの配列
- オブジェクトとして解析される JSON 文字列
ヘッダー名は有効な HTTP トークンである必要があります。ヘッダー値には水平タブを含められますが、キャリッジリターンやラインフィードを含む、それ以外の制御文字は拒否されます。
ヘッダー文字列の配列では、
"Header-Name;"は空のヘッダー値を送信します。各要素にはヘッダーを直接指定する必要があります。@filenameによるファイルからのヘッダー読み込みには対応していません。この
/http/importを使う Step 内のすべての URL に、同じheadersの値が送信されます。urlが配列の場合も、headersが配列のインデックスで各 URL に対応付けられることはありません。URL ごとに異なるヘッダーが必要な場合は、/http/importを使う Step を個別に使用してください。fail_fastboolean(デフォルト:false)内部の再試行機構を無効にし、リソースをインポートできない場合は直ちに失敗とします。パフォーマンスが重要なアプリケーションで役立ちます。
max_file_sizestring | numberインポートする各ファイルの許容最大サイズ(バイト単位)です。リモートサーバーがこれを超えるファイルサイズを報告した場合、ダウンロードの開始前にインポートを拒否します。リモートサーバーが事前にサイズを報告しない場合は、この上限を超えた時点でダウンロードを中止します。
return_file_stubsboolean(デフォルト:false)trueに設定すると、Robot は実際のファイルをまだインポートせず、後続の Robot がファイルをインポートできる URL を含む空のファイルスタブを返します。これは、🤖/video/ondemand を使用する場合など、後続の Step でインポート処理をより細かく制御する必要がある場合に役立ちます。このパラメーターは、後続のすべての Step がファイルスタブに対応した Robot を使用する場合にのみ設定してください。rangestring | Array<string>ファイルからインポートするバイト範囲を一つ以上指定できます。この機能を使用するには、サーバーが範囲リクエストに対応している必要があります。
単一の範囲:
"0-99"のような文字列を指定すると、バイト位置 0 から 99 まで(先頭の 100 バイト)をインポートできます。複数の範囲:
["0-99", "200-299"]のような配列を指定すると、複数の個別の範囲をインポートできます。出力ファイルには、指定したすべての範囲が連結され、連続していない範囲間の隙間はゼロバイト(\0)で埋められます。範囲の指定形式:
"0-99":バイト位置 0 から 99 まで(両端を含む)"100-199":バイト位置 100 から 199 まで(両端を含む)"-100":ファイルの末尾 100 バイト
重要な注意事項:
- サーバーが HTTP 範囲リクエストに対応している必要があります(206 Partial Content で応答)
- サーバーが範囲リクエストに対応していない場合は、代わりにファイル全体をインポートします
- 範囲の重複は許容され、指定どおりに含まれます
- 出力ファイルのサイズは指定した最大のバイト位置となり、隙間はゼロバイトで埋められます
デモ
関連ブログ記事
- 音声エンコード Robot の正式リリースと注目の更新情報
- 機能強化:複数ファイルのインポートと英国の Rackspace アカウントへの対応
- キュー待機時間の増大への対応と信頼性の確保
- ワークフローを強化する Assembly Notification の提供開始
- API と jQuery SDK 2.3.0 の機能改善を発表
- 安全なアップロードを実現する新しいウイルススキャン Robot の紹介
- 今後の Transloadit のお客様向け新料金モデル
- Transloadit、動画エンコードを高速化する Turbo Mode を公開
- 新しい Robot で動画に字幕を簡単に焼き込む
- Creating an Einstein quote generator with Transloadit (English)
- チュートリアル:/video/merge で動画スライドショーを作成
- No-code real-time video uploading with Bubble & Transloadit (English)
- Let's Build: 回転するレコードの GIF ジェネレーター
- Markdown ファイルを数秒で HTML や PDF に変換
- /http/import Robot に即時失敗オプションを追加
- Let's Build: video from album art with Transloadit (English)
- Transloadit の 2021年の節目と進歩
- Build a Reddit video subtitling bot with Transloadit (English)
- Let's Build: Transloadit で作るミュージックカード生成器
- Cloudinary、Filestack、Mux、Uploadcare からの移行
- 機械可読な API:OpenAPI 3.1、Markdown ドキュメント、llms.txt
- Let AI pick your video thumbnails (English)
- 動画機能の新情報:トランジション、チャプター、CMAF など