画像編集 API とは何ですか?
画像編集 API は、リサイズ、切り抜き、合成、フィルター処理、形式変換、背景除去などをプログラムから実行するための操作を提供します。アプリケーションは、完全なエディターを組み込む代わりに、元画像とパラメーターを送信します。
画像編集 API の仕組み
編集サービスは、リクエストの契約として変換処理を公開します。一般的には、アップロード済みオブジェクトまたは元画像への参照と、順序付きの操作群を受け付けます。実行時には、画像のバイト列を同期的に返す場合も、出力を後で取得できるよう保存する非同期ジョブを作成する場合もあります。これにより、デコード、リソース制限、コーデック、変換の意味を、保守される単一の境界の内側にまとめます。アプリケーションは取り込み、編集ツール、配信の段階でこのサービスを統合し、その境界の周囲にキャッシュと可観測性を設けます。
要点
- 呼び出し元が指定した元画像の URL から取得する API では、サーバーサイドリクエストフォージェリとリソース枯渇を防ぐため、スキーム、宛先、リダイレクト、レスポンスサイズを制限する必要があります。
- 正規化した変換パスに署名すると、クライアントによる寸法や高コストな効果の変更を防げます。ただし、署名側と検証側でパラメーターを同じ方法で正規化する必要があります。
- 操作の順序も契約の一部です。回転やリサイズの前に切り抜くと、同じ名前の操作を別の順序で実行した場合とは異なる元画像の画素が選択されることがあります。
画像編集 API が重要になる場面
クライアントごとに画像処理コードを保守するより、変換処理を一元化して一貫性を保つ方が適している場合は、API を使用してください。入力制限、対応形式、レイテンシー、障害処理、同じリクエストを繰り返すと追加の処理が発生するかどうかを考慮してください。