メインコンテンツへスキップ
POST
各ソーシャルネットワークにはソーシャルメディア画像の個別要件があります。resize エンドポイントを使用すると、ソーシャルネットワークに準拠した画像サイズを選択したり、透かしを追加したり、背景を変更したり、エフェクトを適用したり、切り抜きを行ったりできます。 既定では、リサイズは画像の寸法を変更しますが、画像の切り抜きは行いません。代わりに切り抜きも可能です。詳細は下記をご覧ください。

ヘッダーパラメータ

ボディパラメータ

imageUrl
string
必須
リサイズする画像の URL。https:// で始まる必要があります。
platform
array
必須
URL をリサイズするソーシャルメディアプラットフォーム。詳細は platform options をご覧ください。
file
object
メディアファイルを multipart form-data オブジェクトとして送信します。imageUrl がない場合は必須です。
watermark
object
リサイズ後の画像に適用する透かしの URL と任意の位置。既定では透かしは画像の右下隅に表示されます。詳細は watermark をご覧ください。
effects
string
不透明度や色などを変更します。詳細は effects options をご覧ください。
dimensions
object
リサイズ用の widthheight を指定するオブジェクト。切り抜きを行う場合は、任意で中心の xy 座標を指定できます。 既定は画像の中心です。
Dimensions
プラットフォームが指定されていない場合、width と height は必須です。
mode
string
デフォルト:"resize"
値: resizeblur、または crop。詳細は mode をご覧ください。
convertToJpg
boolean
PNG から JPG のように、JPG ファイルに自動変換します。品質は 75% が使用されます。 詳細は convert to a JPG をご覧ください。
convertToWebP
boolean
PNG から WebP のように、WebP ファイルに自動変換します。品質は 75% が使用されます。 詳細は convert to a WebP をご覧ください。

プラットフォームオプション

プラットフォームを文字列で指定すると、画像の事前定義された寸法が使用されます。または dimensions フィールドで独自の寸法を指定できます。 例えば "platform": "facebook" を指定すると、画像の寸法は width 1200px、height 630px に設定されます。
  • facebook: 幅 1200px、高さ 630px。
  • instagram: 幅 1080px、高さ 1080px。
  • instagram_landscape: 幅 1080px、高さ 680px。
  • instagram_portrait: 幅 1080px、高さ 1920px。
  • instagram_special: 幅 1080px、高さ 800px。
  • linkedin: 幅 1200px、高さ 627px。
  • pinterest: 幅 1080px、高さ 1920px。
  • tiktok: 幅 1080px、高さ 1920px。
  • twitter: 幅 1600px、高さ 900px。
これらの寸法へのリサイズでは、画像は切り抜かれない点にご注意ください。 画像を切り抜きたい場合は、mode パラメータを crop に設定し、dimensions および xCoordinateyCoordinate フィールドを使用できます。

Mode

Resize

Resize は既定のモードで、アスペクト比を維持しながら画像の寸法を変更します。 コンテンツを切り抜くことなく、指定された寸法に画像をリサイズします。 JSON の例:
Resize
dimensions フィールドを使用してカスタム寸法を指定することもできます。
Resize with Dimensions
platform か、dimensions フィールドの widthheight のいずれかを指定する必要があります。

Crop

Crop は指定された寸法に画像を「切り抜き」ます。既定では中心座標は画像の中心になります。独自の x/y 座標を指定することもできます。 JSON の例:
Crop
dimensions フィールドを使用してカスタム寸法や任意の切り抜き座標を指定することもできます。
Crop with Dimensions
platform か、dimensions フィールドの widthheight のいずれかを指定する必要があります。 正方形の切り抜きでは、width または height が提供された画像の寸法より小さい場合、width または height の小さい方が使用されます。例えば画像が 1200x800 で、要求された切り抜きが 1080x1080 の場合、返される画像は 800x800 となります。

Blur

Blur エフェクトは画像を背景として複製し、画像をぼかします。 Blur JSON の例:
Blur
Blur 画像の例: Background with Blur

Watermark

Watermark 概要

URL(https:// で始まる必要があります)と任意の位置を指定することで、画像に透かしを追加できます。 既定では透かしは画像の右下隅 — southeast — に表示されます。 背景が透明な PNG を推奨します。 Watermark JSON の例:
Watermark
southeast 位置での透かし画像の例: Add Watermark

Watermark 位置

透かしの位置は以下のいずれかを指定できます。
  • north
  • northeast
  • east
  • southeast
  • south
  • southwest
  • west
  • northwest
  • center

Effects オプション

Color Hexadecimal

Blur の背景色の 16 進数値。"mode": "blur" の場合のみ適用されます。文字列値、例: "#A020F0" Color 背景 JSON の例:
Color Background
Color 背景画像の例: Add Colored Background

Color: Grayscale、Sepia、Invert

grayscalesepiainvert を指定することで、主要な画像の色を変更できます。背景が不要な場合、"blur": true フィールドは必須ではなく、使用すべきではありません。 Grayscale JSON の例:
Grayscale
Grayscale 画像の例: Add Grayscale

Opacity

画像の不透明度を設定します。数値の範囲: 0〜1。 Opacity JSON の例:
Opacity

Quality

JPG または JEPG 画像の場合、画像の品質(圧縮量)を指定します。 数値が小さいほど圧縮率が高くなり画質が下がります。 数値が大きいほど圧縮率が低くなり画質が上がります。数値の範囲: 0〜100。 Quality JSON の例:
Quality

JPG または WebP への変換

convertToJpg および convertToWebP オプションを使用すると、画像を元のフォーマット(PNG など)からそれぞれ JPG または WebP フォーマットに変換できます。 既定では、変換後の画像の品質設定は 75% となります。 エフェクトオブジェクト内の quality パラメータを使用して圧縮レベルをカスタマイズできます。 ソース画像が既に JPG で convertToJpg を使用する場合、API はフォーマットを変更せずに指定された寸法にリサイズするだけである点にご注意ください。 JPG への変換例:
Convert to JPG
WebP への変換例:
Convert to WebP