Transloadit
料金
  • ファイルアップロード
  • ファイルインポート
  • バッチ処理
  • 動画エンコーディング
  • 音声エンコーディング
  • 画像処理
  • ドキュメント処理
  • 人工知能
  • ファイルフィルタリングとセキュリティ
  • メディアカタログ化
  • ファイル圧縮
  • コード評価
  • ファイルエクスポート
  • Smart CDN
  • すべてのサービスを表示
  • 連携機能を見る
  • 実行可能なデモを試す (English)
  • Uppy
  • TransloaditKit
  • Android 用 SDK
  • Node.js 用 SDK
  • Next.js 用ビューアー
  • Python 用 SDK
  • Ruby 用 SDK
  • Go 用 SDK
  • Java 用 SDK
  • PHP 用 SDK
  • Zapier
  • MCP サーバー
  • Transloadit CLI
  • Terraform
  • 基本事項
  • ベストプラクティス
  • よくある質問
  • Robot
  • API
  • 形式
  • 初めてのアプリ開発
  • 会社概要
  • 比較
  • オープンソース
  • お客様の声
  • 採用情報 (English)
  • セキュリティ
  • 記事
  • 開発者ニュース (English)
  • 開発のヒント
  • プレス
  • 研究 (English)
  • 導入事例
  • ソリューション
  • ガイド (English)
  • 用語集
  • 法務 (English)
  • ツール
  • 世界中の数百万人に教育を届ける Coursera を支援
  • Transloadit サポート
  • オープンソースサポート
  • サービスレベル契約 (English)
  • エンジニアによるデモを予約 (English)
基本事項Robotよくある質問API形式ベストプラクティス
ファイルアップロード
  • /upload/handle
    アップロードの処理
ファイルインポート
  • /azure/import
    Azure からファイルをインポート
  • /backblaze/import
    Backblaze からファイルをインポート
  • /box/import
    Box からのファイルのインポート
  • /mega/import
    MEGA S4 Object Storage からファイルをインポート
  • /cloudfiles/import
    Rackspace Cloud Files からのファイルのインポート
  • /cloudflare/import
    Cloudflare R2 からのファイルのインポート
  • /digitalocean/import
    DigitalOcean Spaces からのファイルのインポート
  • /dropbox/import
    Dropbox からファイルをインポート
  • /ftp/import
    FTP サーバーからのファイルインポート
  • /google/import
    Google Cloud Storage からのファイルのインポート
  • /http/import
    ウェブサーバーからのファイルのインポート
  • /minio/import
    MinIO からファイルをインポート
  • /s3/import
    Amazon S3 からファイルをインポート
  • /sftp/import
    SFTP サーバーからファイルをインポート
  • /supabase/import
    Supabase Storage からファイルをインポート
  • /swift/import
    OpenStack Swift からファイルをインポート
  • /tigris/import
    Tigris からファイルをインポート
  • /transloadit/import
    Transloadit ストレージからファイルをインポート
  • /vimeo/import
    Vimeo からの動画インポート
  • /wasabi/import
    Wasabi からファイルをインポート
動画エンコーディング
  • /video/adaptive
    動画を HLS、MPEG-Dash、CMAF に変換
  • /video/artwork
    動画のカバーアートの抽出・挿入
  • /video/concat
    動画の連結
  • /video/encode
    動画のトランスコード・リサイズ・透かし追加
  • /video/merge
    動画・音声・画像を一つの動画に結合
  • /video/ondemand
    オンデマンドエンコードによる動画ストリーミング
  • /video/split
    動画の分割
  • /video/subtitle
    動画への字幕追加
  • /video/thumbs
    動画からのサムネイル抽出
  • 動画プリセット
音声エンコーディング
  • /audio/artwork
    音声のカバーアートの抽出・挿入
  • /audio/concat
    音声の連結
  • /audio/split
    音声の分割
  • /audio/encode
    音声のエンコード
  • /audio/loop
    音声のループ
  • /audio/merge
    音声ファイルを一つに合成
  • /audio/waveform
    音声から波形画像を生成
  • 音声プリセット
画像処理
  • /image/bgremove
    画像の背景除去
  • /image/enhance
    画像の画質向上
  • /image/merge
    複数の画像を一枚の画像に結合
  • /image/optimize
    画像のファイルサイズを最適化
  • /image/resize
    画像の変換、サイズ変更、透かしの追加
ドキュメント処理
  • /document/autorotate
    ドキュメントの自動回転
  • /document/convert
    ドキュメントの別形式への変換
  • /document/extract
    テキストと埋め込み画像の抽出
  • /document/merge
    ドキュメントを一つに結合
  • /document/optimize
    PDF のファイルサイズの最適化
  • /file/read
    ファイル内容の読み取り
  • /document/split
    ページの抽出
  • /document/thumbs
    ドキュメントからサムネイル画像を抽出
  • /document/watermark
    PDF ドキュメントへの透かしの追加
  • /html/convert
    ウェブページや HTML ファイルのスクリーンショット撮影
人工知能
  • /document/ocr
    ドキュメント内のテキスト認識(OCR)
  • /image/describe
    画像内の物体認識
  • /image/facedetect
    画像内の顔検出
  • /image/generate
    テキストプロンプトからの画像生成
  • /image/upscale
    画像をアップスケール
  • /image/ocr
    画像内のテキストを認識(OCR)
  • /speech/transcribe
    音声ファイルまたは動画ファイル内の音声を文字起こし
  • /text/speak
    文書内のテキストから音声を合成
  • /text/translate
    文書内のテキストを翻訳
  • /ai/chat
    AI チャット応答の生成
  • /video/generate
    テキストプロンプトから動画を生成
ファイルフィルタリングとセキュリティ
  • /file/filter
    ファイルのフィルタリング
  • /file/verify
    ファイルの種類の検証
  • /file/virusscan
    ファイルのウイルススキャン
メディアカタログ化
  • /file/hash
    ファイルのハッシュ計算
  • /file/preview
    プレビュー用サムネイルの生成
  • /meta/write
    メディアにメタデータを書き込み
ファイル圧縮
  • /file/compress
    ファイルの圧縮
  • /file/decompress
    アーカイブの展開
コード評価
  • /http/request
    HTTP エンドポイントの呼び出し
  • /script/run
    Assembly 内でスクリプトを実行
ファイルエクスポート
  • ダウンロード
  • /azure/store
    Microsoft Azure にファイルをエクスポート
  • /backblaze/store
    Backblaze にファイルをエクスポート
  • /box/store
    Box へのファイルのエクスポート
  • /mega/store
    MEGA S4 Object Storage にファイルをエクスポート
  • /cloudfiles/store
    Rackspace Cloud Files へのファイルのエクスポート
  • /cloudflare/store
    Cloudflare R2 へのファイルのエクスポート
  • /digitalocean/store
    DigitalOcean Spaces へのファイルのエクスポート
  • /dropbox/store
    Dropbox にファイルをエクスポート
  • /ftp/store
    FTP サーバーへのファイルエクスポート
  • /google/store
    Google Cloud Storage へのファイルのエクスポート
  • /minio/store
    MinIO にファイルをエクスポート
  • /s3/store
    Amazon S3 にファイルをエクスポート
  • /sftp/store
    SFTP サーバーにファイルをエクスポート
  • /supabase/store
    Supabase Storage にファイルをエクスポート
  • /swift/store
    OpenStack Swift にファイルをエクスポート
  • /tigris/store
    Tigris にファイルをエクスポート
  • /transloadit/store
    Transloadit ストレージにファイルを保存
  • /tus/store
    tus 対応サーバーにファイルをエクスポート
  • /vimeo/store
    Vimeo へのファイルエクスポート
  • /wasabi/store
    Wasabi にファイルをエクスポート
  • /youtube/store
    YouTube にファイルをエクスポート
Smart CDN
  • /file/serve
    ウェブブラウザーへのファイル配信
  • /tlcdn/deliver
    ファイルをキャッシュして世界中に配信
  • 料金

画像の変換、サイズ変更、透かしの追加

🤖/image/resize は、画像のサイズ変更、切り抜き、色調変更、回転に加え、テキストや透かしの追加を行います。

/image/resize の Robot

RAW 変換の更新

画像処理スタック v2.0.11 と v3.0.2 では、RAW デコードを更新しています。RAW 変換の結果は、色や細部のわずかな変化など、見た目が多少異なります。以前の v2/v3 を選択している場合は、同じメジャーバージョン内でアップグレードされます。その他の画像形式に変更はありません。

使用例

アップロードした画像の元のアスペクト比を維持しながら、幅を 200px に変更する例:

{
  "steps": {
    "resized": {
      "robot": "/image/resize",
      "use": ":original",
      "width": 200
    }
  }
}

パラメーター

  • interpolate

    boolean | Record<string, boolean>

    処理設定の各フィールドで Assembly Variables を展開するかどうかを制御します。

    デフォルトでは、Robot の処理設定のほとんどのフィールドで Assembly Variables が展開されます。すべての設定フィールドをリテラルテキストとして扱うには、このパラメーターを false に設定してください。特定のフィールドだけをリテラルテキストとして扱うには、そのフィールドのパスを false に設定してください。デフォルトでリテラルとして扱われる Robot 固有のフィールドで展開を有効にするには、このパラメーターを true に設定するか、そのフィールドのパスを true に設定してください。

    path のようなフィールド名を使用してください。ネストされたオブジェクトには、ffmpeg.vf のようなドット区切りのパスを使用してください。

  • output_meta

    Record<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_meta

    Record<string, any>(デフォルト:{})

    出力される各ファイルに、ファイルの内容を変更せずにカスタム JSON メタデータを追加します。ネストしたオブジェクトと配列に対応しています。

    継承の動作は Robot によって異なります。値は出力ファイルの既存の user_meta とマージされ、一致するトップレベルのキーは現在の Step によって置き換えられます。Robot が新しい出力を作成する場合は、必要なキーを明示的に割り当ててください。

    処理 Step では、${file.*} は最初の入力を、${result.*} は出力されるファイルを参照します。値は Robot の実行後、後続のメタデータ抽出と一時保存の前に、出力ごとに評価されます。:original では、メタデータ抽出の前にアップロードごとに値が評価されます。

    後続の Step は ${file.user_meta.key} を読み取ります。完全な例と継承ルールについては、カスタムメタデータ を参照してください。

  • result

    boolean(デフォルト:false)

    この Step の結果を Assembly Status JSON に含めるかどうか

  • queue

    batch

    queue を 'batch' に設定すると、このステップのジョブの優先度を手動で下げ、キューの待ち時間がゼロである必要のないジョブが優先ジョブスロットを消費しないようにします。

  • force_accept

    boolean(デフォルト:false)

    通常は無視するファイルタイプを Robot に強制的に受け入れさせます。

    デフォルトでは、Robot は認識できないファイルを無視します。たとえば、🤖/video/encodeは入力画像を無視します。

    force_accept パラメーターを true に設定すると、Robot に渡されたすべてのファイルを強制的に受け入れさせることができます。通常、この設定はエラーにつながるため、デバッグやエッジケースへの対処にのみ使用してください。

  • ignore_errors

    boolean | Array<meta | execute>(デフォルト:[])

    処理の特定のフェーズでエラーを無視します。

    このパラメーターを ["meta"] に設定すると、Robot はメタデータ抽出中のエラーを無視します。

    このパラメーターを ["execute"] に設定すると、Robot はメイン実行フェーズ中のエラーを無視します。

    このパラメーターを true に設定すると、["meta", "execute"] と同じ動作になり、両方のフェーズでエラーを無視します。

  • use

    string | Array<string> | Array<object> | object

    入力として使用する Step を指定します。

    • Step には任意の名前を付けられます。ただし、":original" は Transloadit が処理するユーザーアップロード用に予約されています。
    • 配列を使用して、複数の Step を入力として指定できます。
      {
        "use": [
          ":original",
          "encoded",
          "resized"
        ]
      }
      
    • 入力 Step に as でタグを付けて、意味上の用途を Robot に伝えることもできます。
      {
        "use": [
          {
            "name": ":original",
            "as": "image"
          },
          {
            "name": ":original",
            "as": "mask"
          }
        ]
      }
      
    ヒント

    use については、通常ここまでの内容で十分ですが、高度な使用例 も参照できます。

  • format

    string | null(デフォルト:null)

    加工後の画像の出力形式です。

    主な利用可能な形式には、"jpg"、"png"、"gif"、"tiff"、および JPEG XL 用の "jxl" があります。書き込み可能な形式の全一覧は、対応画像形式の一覧を参照してください。

    null(デフォルト)の場合、入力画像の形式が出力形式として使用されます。

    "pdf" に変換する場合は、代わりに 🤖/document/convertの利用をご検討ください。

  • width

    number

    出力の幅をピクセル単位で指定します。省略した場合は、元の画像の幅が使われます。

  • height

    number

    新しい画像の高さ(ピクセル単位)です。指定しない場合は、入力画像の高さがデフォルトで使用されます。

  • resize_strategy

    "crop" | "fillcrop" | "fit" | "min_fit" | "pad" | "stretch"(デフォルト:"fit")

    利用可能なリサイズ方式の一覧を参照してください。

  • zoom

    boolean(デフォルト:true)

    false に設定すると、小さい画像を指定の幅と高さまで引き伸ばしません。使用するリサイズ方式での拡大の影響については、利用可能なリサイズ方式の一覧を参照してください。

  • crop

    object | string

    元画像から切り抜く矩形の左上と右下の座標を含むオブジェクトを指定します。座標系の原点は画像の左上です。値には、絶対ピクセル値を表す整数、またはパーセント値を表す文字列を指定できます。

    例:

    {
      "x1": 80,
      "y1": 100,
      "x2": "60%",
      "y2": "80%"
    }
    

    この例では、1000×1000 ピクセルの画像から、(80, 100) から (600, 800) までの領域を切り抜きます。切り抜く矩形の幅は 520px 、高さは 700px です。crop を設定すると、幅と高さのパラメーターは無視され、resize_strategy は自動的に crop に設定されます。

    同様に、座標を含むオブジェクトを JSON 文字列として指定することもできます。

    "{\"x1\": <Integer>, \"y1\": <Integer>, \"x2\": <Integer>, \"y2\": <Integer>}"
    

    人物の顔を中心に切り抜くには、🤖/image/facedetect を参照してください。

  • gravity

    bottom | bottom-left | bottom-right | center | left | right | top | | attention | entropy(デフォルト:"center")

    明示的な座標を指定せずに、crop または fillcrop の切り抜き方向を設定します。コンテンツに応じた attention と entropy には、libvips、fillcrop、width、height が必要です。sepia や text などのエフェクト、および HEIC などの入力では、ImageMagick が使用されることがあります。その場合、切り抜き位置は中央になり、Assembly が警告を報告します。エフェクトを適用する前に、別の /image/resize Step で切り抜くか、未対応の入力を先に PNG に変換してください。

  • strip

    boolean(デフォルト:false)

    画像からすべてのメタデータを削除します。サムネイルのサイズをできるだけ小さくするのに役立ちます。

  • alpha

    Activate | Background | Copy | Deactivate | Extract | Off | On |

    画像のアルファ/マットチャンネルを制御します。

  • preclip_alpha

    Activate | Background | Copy | Deactivate | Extract | Off | On |

    clip: true によるクリッピングパスの適用前に、画像のアルファ/マットチャンネルを制御します。

  • flatten

    boolean(デフォルト:true)

    ImageMagick のドキュメント⁠で説明されているように、すべてのレイヤーを指定した背景に統合し、透過形式から非透過形式への変換結果を改善します。

    アニメーションを保持するため、この値が true に設定されている場合、GIF ファイルは統合されません。GIF アニメーションを統合するには、frame パラメーターを使用してください。

  • correct_gamma

    boolean(デフォルト:false)

    多くの画像拡大縮小アルゴリズムでよく発生する⁠ガンマ誤差を防ぎます。

  • quality

    string | number(デフォルト:92)

    JPG 画像と PNG 画像の圧縮を制御します。🤖/image/optimizeも参照してください。

  • adaptive_filtering

    boolean(デフォルト:false)

    PNG 画像の圧縮を制御します。true に設定すると、ファイルサイズは小さくなりますが、処理時間は長くなります。このオプションは無効のままにしておくことをお勧めします。

  • background

    string | transparent | none | black | white | red | green | blue | (デフォルト:"#FFFFFF")

    背景の塗りつぶしに使用する色を、16 進コードまたは色名⁠で指定します(リサイズ方式 pad で使用します)。

    注意: デフォルトでは、透明な画像の背景は白に変更されます。透明度を保持するには、"background" を "none" に設定してください。

  • frame

    string | number | null(デフォルト:null)

    アニメーション GIF ファイルを処理する際に、このパラメーターで処理対象のフレームを指定します。最初のフレームを使用するには 1、2番目には 2 というように指定してください。null はすべてのフレームを意味します。

  • colorspace

    CMY | CMYK | Gray | HCL | HCLp | HSB | HSI |

    画像の色空間を設定します。使用できる値の詳細は、ImageMagick のドキュメント⁠を参照してください。"RGB" を使用していた場合、2014-02-04 以降では代わりに "sRGB" の使用を推奨します。ImageMagick は画像の色に基づいて最も効率的な colorspace を探し、たとえば "Gray" をデフォルトとして使用することがあります。色を強制的に指定するには、このパラメーターを type: "TrueColor" と組み合わせる必要がある場合があります。

  • type

    Bilevel | ColorSeparation | ColorSeparationAlpha | Grayscale | GrayscaleAlpha | Palette | PaletteAlpha |

    画像のカラータイプを設定します。指定できる値の詳細は、ImageMagick のドキュメント⁠を参照してください。colorspace を使用すると、ImageMagick が画像の色に基づいて最も効率的なタイプを選ぼうとして、たとえば "Gray" をデフォルトとして使用する場合があります。カラーを強制するには、たとえばこのパラメーターを "TrueColor" に設定できます。

  • sepia

    string | number | null(デフォルト:null)

    セピア調の効果をパーセント単位で適用します。

  • rotation

    string | number | boolean | "auto"(デフォルト:true)

    画像を回転するかどうかを指定します。任意の数値で回転角度を度単位で指定してください(例:90、180、270、360、または 2.9 のような精密な値)。向きが正しくない画像や EXIF の回転設定に依存する画像を自動回転するには、true または "auto" を使用してください。自動補正を完全に無効にするには、false を使用してください。

  • compress

    BZip | Fax | Group4 | JPEG | JPEG2000 | Lossless | LZW | | null(デフォルト:null)

    画像の書き出し時に使用するピクセル圧縮を指定します。デフォルトでは圧縮は無効です。

    🤖/image/optimizeも参照してください。

  • blur

    string | null(デフォルト:null)

    {radius}x{sigma} 形式の値で、ガウスぼかしを指定します。radius 値は、ピクセルを拡散する際に演算子が参照する領域の大きさを指定します。通常は "0" または sigma 値の少なくとも二倍にします。sigma 値は、画像を何ピクセル程度「拡散」させるかを表します。画像をぼかすブラシの大きさと考えてください。この値は浮動小数点数なので、"0.5" のような小さな値も使用できます。

  • blur_regions

    Array<object> | null(デフォルト:null)

    画像上でぼかす楕円領域を、オブジェクトの配列で指定します。各オブジェクトには、x、y、width、height のキーがあります。blur_regions に値がある場合、各領域のぼかしの強さには blur パラメーターを使用します。

  • brightness

    string | number(デフォルト:1)

    倍率を使用して画像の明るさを増減します。たとえば、1.5 では明るさが 50% 増加し、0.75 では 25% 減少します。

  • saturation

    string | number(デフォルト:1)

    倍率を使って画像の彩度を増減します。たとえば、1.5 では彩度が 50% 増加し、0.75 では 25% 減少します。

  • hue

    string | number(デフォルト:100)

    画像の色を回転させて色相を変更します。値が 100 の場合は変化せず、0 と 200 の場合は画像の色が反転します。

  • contrast

    string | number(デフォルト:1)

    画像のコントラストを調整します。1 では変化しません。1 未満の値ではコントラストが低下し、1 を超える値では増加します。まずは 0.9 や 1.1 などの小さな調整から始めてください。大幅に増加させると、シャドウやハイライトがクリッピングされることがあります。

  • watermark_url

    string

    この画像に重ねる PNG 画像の URL です。別の Assembly Step からウォーターマークを指定することもできます。ウォーターマーク機能では、ある画像に別の画像を重ねられます。通常はロゴに使用します。

  • watermark_position

    bottom | bottom-left | bottom-right | center | left | right | top | | Array<bottom | bottom-left | bottom-right | center | left | right | top | >(デフォルト:"center")

    ウォーターマークを配置する位置です。指定できる値は "center"、"top"、"bottom"、"left"、"right" です。"bottom-right" のように組み合わせることもできます。

    [ "center", "left", "bottom-left", "bottom-right" ] のように候補の値を配列で指定することもできます。その場合、いずれかの値がランダムに選択されます。

    この設定では、指定した隅にウォーターマークを配置します。ウォーターマークの位置を特定のピクセル数だけずらすには、画像自体にパディングを追加する必要があります。

  • watermark_x_offset

    string | number(デフォルト:0)

    watermark_position で決まる配置位置を基準に、ウォーターマークを x 方向にずらすピクセル数です。

    正の値と負の値を指定でき、結果は watermark_position パラメーターによって異なります。正の値では透かしが画像の中心に近づき、負の値では中心から遠ざかります。

  • watermark_y_offset

    string | number(デフォルト:0)

    watermark_position で決まる位置を基準に、透かしを配置する y 方向のオフセットをピクセル数で指定します。

    正の値と負の値を指定でき、結果は watermark_position パラメーターによって異なります。正の値では透かしが画像の中心に近づき、負の値では中心から遠ざかります。

  • watermark_size

    string

    パーセントで指定するウォーターマークのサイズです。

    たとえば、値が "50%" の場合、ウォーターマークのサイズは配置先の画像のサイズの 50% になります。正確なサイズは watermark_resize_strategy にも依存します。

    watermark_repeat_x または watermark_repeat_y を使用する場合、繰り返し配置する前に、出力画像に対する各タイルのサイズを設定します。パターン全体が画像を覆う割合を設定するものではありません。値を小さくすると、タイルが小さくなり、数が増えます。省略すると、ウォーターマークは元のピクセル寸法を維持します。

  • watermark_resize_strategy

    area | fit | min_fit | stretch(デフォルト:"fit")

    指定できる値は "fit"、"min_fit"、"stretch"、"area" です。

    リサイズ方式の動作を説明するため、対象画像のサイズを 800×800 ピクセル、ウォーターマーク画像のサイズを 400×300 ピクセルとします。また、watermark_size パラメーターは "25%" に設定されているものとします。

    "fit" のリサイズ方式では、ウォーターマークの長辺が、対応する画像の辺の 25% を占めるように拡大縮小します。もう一方の辺は、ウォーターマーク画像のアスペクト比に従って拡大縮小します。この例ではウォーターマークの幅が長辺で、画像サイズの 25% は 200px です。そのため、ウォーターマークは 200×150 ピクセルにリサイズされます。watermark_size が "50%" に設定されている場合は、400×300 ピクセルになります(元のサイズのままです)。

    "min_fit" のリサイズ方式では、ウォーターマークの短辺が、対応する画像の辺の 25% を占めるように拡大縮小します。もう一方の辺は、ウォーターマーク画像のアスペクト比に従って拡大縮小します。この例ではウォーターマークの高さが短辺で、画像サイズの 25% は 200px です。そのため、ウォーターマークは 267×200 ピクセルにリサイズされます。watermark_size が "50%" に設定されている場合は、533×400 ピクセルになります(元のサイズより大きくなります)。

    "stretch" のリサイズ方式では、両辺がそれぞれ対応する画像の辺の 25% を占めるように、ウォーターマークを引き伸ばします(アスペクト比を維持せずにリサイズします)。画像は 800×800 ピクセルなので、ウォーターマークのサイズが 25% の場合、ウォーターマークは 200×200 ピクセルにリサイズされます。アスペクト比を維持した場合は 200×150 ピクセルになるため、高さ方向に引き伸ばされて見えます。

    "area" のリサイズ方式では、画像の面積の "xx%" を覆うように、アスペクト比を維持してウォーターマークをリサイズします。面積の割合には watermark_size の値を使用します。

  • watermark_opacity

    string | number(デフォルト:1)

    ウォーターマークの不透明度です。0.0 は完全に透明、1.0 は完全に不透明です。

    たとえば、値が 0.5 の場合、ウォーターマークは 50% 透明になり、下の画像が透けて見えます。控えめにブランドを示したい場合や、ウォーターマークを目立たなくしたい場合に役立ちます。

  • watermark_repeat_x

    boolean(デフォルト:false)

    true に設定すると、画像の幅全体にわたってウォーターマークを水平方向に繰り返し配置します。

    画像全体を覆うタイル状のウォーターマークパターンを作成し、切り抜きによるウォーターマークの除去を難しくするのに役立ちます。

  • watermark_repeat_y

    boolean(デフォルト:false)

    true に設定すると、画像の高さ全体にわたってウォーターマークを垂直方向に繰り返し配置します。

    画像全体を覆うタイル状のウォーターマークパターンを作成するのに役立ちます。watermark_repeat_x と組み合わせると、両方向にタイル状に配置できます。

  • text

    object | Array<object>

    画像に適用するテキストオーバーレイです。単一のテキストオブジェクト、またはテキストオブジェクトの配列を指定できます。各テキストオブジェクトにはテキストのルールが含まれます。以下のテキストパラメーターは、テキストオーバーレイのプロパティとして使用します。次に例を示します。

    "watermarked": {
      "use": "resized",
      "robot": "/image/resize",
      "text": [
        {
          "text": "© 2018 Transloadit.com",
          "size": 12,
          "font": "Ubuntu",
          "color": "#eeeeee",
          "valign": "bottom",
          "align": "right",
          "x_offset": 16,
          "y_offset": -10
        }
      ]
    }
    
  • progressive

    boolean(デフォルト:false)

    true に設定すると画像をインターレース化し、ブラウザーで段階的に読み込めるようにします。ブラウザーは画像を上から下へ描画する代わりに、まず低解像度のぼやけた画像を表示し、データの到着に合わせてすばやく実際の画像に置き換えます。ユーザー体験が大きく向上する一方、ファイルサイズは約 10% 増加します。

  • transparent

    string | transparent | none | black | white | red | green | blue | | string

    画像内の指定した色を透明にします。例:"255,255,255"。

  • trim_whitespace

    boolean(デフォルト:false)

    画像の周囲にある余分な余白を最初に削除するかどうかを指定します。true に設定すると、隅のピクセルと完全に同じ色の端の領域を削除します。

  • clip

    string | boolean(デフォルト:false)

    クリッピングパスが存在する場合、リサイズ処理内のほかの操作に適用します。true に設定すると、最初のクリッピングパスを自動的に使用します。文字列に設定すると、その名前のクリッピングパスを検索します。

  • negate

    boolean(デフォルト:false)

    各ピクセルを補色に置き換え、画像の色を反転します。特にクリッピングのテストに便利です。

  • clut

    boolean(デフォルト:false)

    ImageMagick の -clut 演算子を使用して、Color Look-Up Table(CLUT)画像を適用し、入力画像の色を再マッピングします。有効にする場合は、use パラメーターで "as": "clut" を指定し、二つ目の入力ファイルを渡す必要があります。

    現在、この操作は stack: "daemon" が要求されていても、image-resizer デーモンではなく ImageMagick convert スタックで実行されます。

    複数の入力を使用する場合は、メイン画像を "as": "base" として指定してください。base エイリアスが明示的に設定されていない場合、Transloadit は補助入力ではない最初の入力(watermark または clut のタグが付いていないファイル)をメイン画像として使用します。

    CLUT 画像はグラデーションマップとして機能します。入力の各ピクセルのカラーチャンネルは、チャンネルの強度に基づいて、CLUT 画像の対応する色に置き換えられます。これは、写真やデザインのワークフローで広く使用されている強力なカラーグレーディング手法です。

    例:

    {
      "steps": {
        ":original": {
          "robot": "/upload/handle"
        },
        "lut_image": {
          "robot": "/upload/handle"
        },
        "color_graded": {
          "robot": "/image/resize",
          "use": {
            "steps": [
              { "name": ":original", "as": "base" },
              { "name": "lut_image", "as": "clut" }
            ]
          },
          "clut": true
        }
      }
    }
    
  • density

    string | null(デフォルト:null)

    メモリ上の品質とファイル形式のビット深度が色の解像度を指定するのに対し、画像の密度は空間解像度を表します。つまり、画像の密度(1 インチあたりのピクセル数)は、個々のピクセルの間隔(または大きさ)を定義します。これにより、デバイスでの表示時や印刷時の画像の物理的なサイズが決まります。

    この値には、特定の width、または widthxheight という形式を指定できます。

    変換後の画像が不鮮明な場合は、密度を上げてみてください。

  • monochrome

    boolean(デフォルト:false)

    画像を白黒に変換します。これは colorspace を Gray、type を Bilevel に設定する操作のショートカットです。

  • shave

    string | number

    画像の端からピクセルを削除します。値は width または widthxheight の形式で指定し、各辺から削除するピクセル数を表します。

デモ

  • Service to automatically watermark current date onto image EN (English)
  • Rotate image to portrait mode if horizontal EN (English)
  • Service to add a sepia effect to an image EN (English)
  • Resize and apply transparency, based on a clipping path EN (English)
  • Convert specific colors to transparency EN (English)
  • Service to convert images to WebP EN (English)
  • Service to remove a color around the edge of images EN (English)
  • Service to automatically crop images to Twitter cover dimensions EN (English)
  • Service to automatically add a text watermark to images EN (English)

関連ブログ記事

  • お使いの画像拡大・縮小ソフトウェアは適切に処理できていますか? 2010年10月15日
  • 座標ベースの画像切り抜き機能の紹介 2011年1月31日
  • 画像リサイズ Robotの回転機能を公開 2011年4月1日
  • 画像リサイズ Robot の Zoom 更新を公開 2011年5月9日
  • 新しい「frame」パラメーターで GIF 操作を強化 2011年5月26日
  • 音声エンコード Robot の正式リリースと注目の更新情報 2011年11月21日
  • 「fillcrop」リサイズ戦略と Assembly の詳細情報 2012年2月14日
  • スケーリング強化による安定性とパフォーマンスの向上 2012年7月24日
  • 画像リサイズ Robot にぼかし機能が登場 2012年10月21日
  • Transloadit が画像のプログレッシブ表示に対応 2012年12月11日
  • Transloadit が SVG 画像に対応 2013年3月23日
  • 音声ファイルからアートワークを抽出する新しい Robot のご紹介 2014年6月20日
  • Assembly を高速化する大幅なパフォーマンス改善 2015年3月4日
  • ImageTragick について(CVE-2016-3714) 2016年5月4日
  • ImageMagick の新バージョンを公開 2017年7月20日
  • 今後の Transloadit のお客様向け新料金モデル 2018年2月7日
  • crop リサイズ方式での意図しない破壊的変更 2018年6月6日
  • Ghostscript のセキュリティインシデント(VU#332928) 2018年8月30日
  • Transloadit の「output_meta」パラメーターを解説 2019年3月20日
  • Creating an Einstein quote generator with Transloadit EN (English) 2019年5月14日
  • セキュリティ強化:ImageMagick の脆弱性修正 2019年7月30日
  • ImageMagick と FFmpeg の旧スタックの非推奨化 2019年9月5日
  • Let's Build: 回転するレコードの GIF ジェネレーター 2021年4月1日
  • コード評価用の /script/run Robot の紹介 2021年12月15日
  • Transloadit で位置情報を画像に透かしとして追加するツールの作成 2022年5月5日
  • Let's Build: Transloadit で作るミュージックカード生成器 2022年5月5日
  • 画質を損なわずに画像ファイルのサイズを削減する方法 2022年8月3日
  • スプライトシート用の /image/merge Robot の紹介 2022年9月12日
  • Transloadit と Uppy でオリジナルのバレンタインカードを作成 2023年1月26日
  • Transloadit 用の S3 バケットを設定する方法 2023年3月25日
  • Transloadit の専門用語を読み解く総合ガイド 2023年4月27日
  • Transloadit であらゆるデバイス向けの壁紙を簡単に作成 2023年6月12日
  • Transloadit で写真の顔をぼかす方法 2023年7月4日
  • Transloadit で著作権メタデータを確認し画像に透かしを追加 2024年7月7日
  • 画像の背景を自動削除 2025年3月10日
  • 1つの Assembly で低解像度画像を拡大・補正 2026年3月18日
  • コンテンツに応じた切り抜きで被写体をフレーム内に保持 2026年6月22日
  • Cloudinary、Filestack、Mux、Uploadcare からの移行 2026年9月9日
  • Transloadit CLI でゼロから始めるファイル処理 2026年9月21日
  • 機械可読な API:OpenAPI 3.1、Markdown ドキュメント、llms.txt 2026年9月24日
  • Transloadit があなたの言語に対応 2026年9月30日
前のページ ← /image/optimize次のページ /document/autorotate →
サポートに問い合わせる
Transloadit稼働状況を確認中…

製品

  • サービス
  • 料金
  • デモ EN (English)
  • ツール
  • セキュリティ
  • サポート

会社

  • 会社概要/プレス
  • ブログ/採用情報 EN (English)
  • 比較/コンプライアンス対応表
  • 研究 EN (English)
  • オープンソース
  • ソリューション
  • ウェブの先駆者たち

ドキュメント

  • はじめに
  • トランスコーディング
  • よくある質問
  • API
  • ガイド EN (English)/開発のヒント
  • 対応フォーマット

その他

  • プラットフォームの稼働状況⁠
  • コミュニティフォーラム⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®、tus®、Uppy® は、米国における Transloadit-II GmbH の登録商標です。

プライバシー EN (English)利用規約 EN (English)運営者情報 EN (English)商標 EN (English)DMCA ポリシー EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語