跳转到主要内容
POST
各社交网络对社交媒体图片有特定要求。resize 端点允许你选择兼容各社交网络的图片尺寸,添加水印、更换背景、添加特效、裁剪等。 默认情况下,调整尺寸会改变图片的尺寸,但不会裁剪图片。你也可以选择裁剪图片。详见下文。

Header Parameters

Body Parameters

imageUrl
string
必填
待调整尺寸的图片 URL。必须以 https:// 开头。
platform
array
必填
要为哪个社交媒体平台调整 URL。详见平台选项
file
object
以 multipart form-data 对象形式发送媒体文件。当未提供 imageUrl 时必填。
watermark
object
应用到调整后图片上的水印 URL 及可选位置。默认情况下,水印会出现在图片的右下角。详见watermark
effects
string
更改不透明度、颜色等。详见effects options
dimensions
object
指定调整尺寸的 widthheight 的对象。若为裁剪,可选择性地指定中心 xy 坐标。 默认为图片中心。
Dimensions
如果未指定 platform,则 width 和 height 必填。
mode
string
默认值:"resize"
取值:resizeblurcrop。详见mode
convertToJpg
boolean
自动将文件转换为 JPG,例如将 PNG 转换为 JPG。将使用 75% 的质量。 详见转换为 JPG
convertToWebP
boolean
自动将文件转换为 WebP,例如将 PNG 转换为 WebP。将使用 75% 的质量。 详见转换为 WebP

平台选项

以字符串形式指定平台,即可使用预定义的图片尺寸,你也可以通过 dimensions 字段自定义。 例如,"platform": "facebook" 将把图片尺寸设置为宽 1200px、高 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 对于方形裁剪,如果 widthheight 小于所提供图片的尺寸,则会使用 widthheight 中较小的那个值。例如,若图片为 1200x800 而请求的裁剪尺寸为 1080x1080,返回的图片将为 800x800。

Blur

Blur 效果会复制一份图片作为背景,并对其进行模糊处理。 示例 blur JSON:
Blur
模糊效果示例图: Background with Blur

Watermark

水印概览

你可以通过提供一个必须以 https:// 开头的 URL(以及可选的位置)为图片添加水印。 默认情况下,水印会出现在图片的右下角 —— southeast 我们建议使用带透明背景的 PNG。 示例 watermark JSON:
Watermark
位于 southeast 位置的水印示例图: Add Watermark

水印位置

水印位置可以是以下值之一:
  • north
  • northeast
  • east
  • southeast
  • south
  • southwest
  • west
  • northwest
  • center

Effects 选项

十六进制颜色

背景模糊颜色的十六进制值。仅当 "mode": "blur" 时适用。字符串值,例如 "#A020F0" 示例背景色 JSON:
Color Background
背景色示例图: Add Colored Background

颜色:灰度、复古、反色

你可以通过指定 grayscalesepiainvert 更改图片的主色调。"blur": true 字段不是必需的,如果你不想要背景,请勿使用。 示例灰度 JSON:
Grayscale
灰度示例图: Add Grayscale

不透明度

设置图片的不透明度。数值范围:0 - 1。 示例 opacity JSON:
Opacity

质量

对于 JPG 或 JEPG 图片,可指定图片的质量(即压缩程度)。 数值越低压缩越强,但图片质量越低。 数值越高压缩越弱,但图片质量越高。数值范围:0 - 100。 示例 quality JSON:
Quality

转换为 JPG 或 WebP

convertToJpgconvertToWebP 选项允许你将图片从其原始格式(例如 PNG)分别转换为 JPG 或 WebP 格式。 默认情况下,转换后的图片使用 75% 的质量设置。 你可以通过 effects 对象中的 quality 参数自定义压缩级别。 请注意,如果源图片已经是 JPG 且你使用了 convertToJpg,API 只会将图片调整为指定尺寸,而不会改变格式。 示例转换为 JPG:
Convert to JPG
示例转换为 WebP:
Convert to WebP