Pular para o conteúdo principal
POST
As redes sociais têm requisitos específicos para imagens. O endpoint de redimensionamento permite escolher um tamanho de imagem compatível com a rede social, adicionar marcas d’água, alterar fundos, adicionar efeitos, cortar e muito mais. Por padrão, o redimensionamento altera as dimensões de uma imagem, mas não corta a imagem. Você também pode cortar a imagem. Veja abaixo os detalhes.

Parâmetros do header

Parâmetros do body

imageUrl
string
obrigatório
URL da imagem a ser redimensionada. Deve começar com https://
platform
array
obrigatório
Plataforma de rede social para a qual a URL será redimensionada. Veja as opções de plataforma para detalhes.
file
object
Envie o arquivo de mídia como um objeto multipart form-data. Obrigatório se imageUrl não estiver presente.
watermark
object
URL e posição opcional da marca d’água a ser aplicada à imagem redimensionada. A marca d’água aparecerá no canto inferior direito da imagem por padrão. Veja watermark para detalhes.
effects
string
Altera opacidade, cores, etc. Veja as opções de efeitos para detalhes.
dimensions
object
Objeto especificando width e height para redimensionamento. Ao cortar, você pode opcionalmente especificar as coordenadas centrais x e y. O padrão é o centro da imagem.
Dimensions
Largura e altura obrigatórias se a plataforma não for especificada.
mode
string
padrão:"resize"
Valor: resize, blur ou crop. Veja mode para detalhes.
convertToJpg
boolean
Converte automaticamente para um arquivo JPG, como de um PNG para um arquivo JPG. Será utilizada a qualidade de 75%. Veja converter para JPG para detalhes.
convertToWebP
boolean
Converte automaticamente para um arquivo WebP, como de um PNG para um arquivo WebP. Será utilizada a qualidade de 75%. Veja converter para WebP para detalhes.

Opções de plataforma

Especifique uma plataforma como uma String para usar as dimensões predefinidas da imagem, ou especifique as suas próprias com o campo dimensions. Por exemplo, "platform": "facebook" definirá as dimensões da imagem como largura 1200px e altura 630px.
  • facebook: 1200px de largura, 630px de altura.
  • instagram: 1080px de largura, 1080px de altura.
  • instagram_landscape: 1080px de largura, 680px de altura.
  • instagram_portrait: 1080px de largura, 1920px de altura.
  • instagram_special: 1080px de largura, 800px de altura.
  • linkedin: 1200px de largura, 627px de altura.
  • pinterest: 1080px de largura, 1920px de altura.
  • tiktok: 1080px de largura, 1920px de altura.
  • twitter: 1600px de largura, 900px de altura.
Observe que o redimensionamento para essas dimensões não cortará a imagem. Se quiser cortar a imagem, você pode usar o parâmetro mode definido como crop com os campos dimensions e xCoordinate e yCoordinate.

Mode

Resize

Resize é o modo padrão que altera as dimensões de uma imagem mantendo sua proporção. Redimensiona a imagem para as dimensões especificadas sem cortar qualquer conteúdo. Exemplo de JSON:
Resize
Você também pode especificar dimensões personalizadas usando o campo dimensions:
Resize with Dimensions
É necessário especificar platform ou os campos width e height em dimensions.

Crop

Crop irá cortar (“crop”) a imagem para as dimensões especificadas. Por padrão, a coordenada central será o centro da imagem. Você também pode especificar suas próprias coordenadas x/y. Exemplo de JSON:
Crop
Você também pode especificar dimensões personalizadas e coordenadas de corte opcionais usando o campo dimensions:
Crop with Dimensions
É necessário especificar platform ou os campos width e height em dimensions. Para cortes quadrados, se width ou height forem menores que as dimensões da imagem fornecida, o menor valor entre width ou height será usado. Por exemplo, se a imagem for 1200x800 e o corte solicitado for 1080x1080, a imagem retornada será 800x800.

Blur

O efeito blur duplica a imagem como fundo e desfoca a imagem. Exemplo de JSON de blur:
Blur
Exemplo de imagem com blur: Background with Blur

Watermark

Visão geral do watermark

Você pode adicionar uma marca d’água à imagem fornecendo uma URL, que deve começar com https:// e uma posição opcional. A marca d’água aparecerá por padrão no canto inferior direito da imagem - southeast. Recomendamos um PNG com fundo transparente. Exemplo de JSON de watermark:
Watermark
Exemplo de imagem com watermark na posição southeast: Add Watermark

Posição do watermark

A posição da marca d’água pode ser uma das seguintes:
  • north
  • northeast
  • east
  • southeast
  • south
  • southwest
  • west
  • northwest
  • center

Opções de efeitos

Cor em hexadecimal

Valor hexadecimal da cor do fundo para blur. Aplicável somente se "mode": "blur". Valor de string, ex.: "#A020F0" Exemplo de JSON de fundo com cor:
Color Background
Exemplo de imagem com fundo colorido: Add Colored Background

Cor: Grayscale, Sepia, Invert

Você pode alterar a cor primária da imagem especificando grayscale, sepia ou invert. O campo "blur": true não é obrigatório e não deve ser usado se você não quiser um fundo. Exemplo de JSON de grayscale:
Grayscale
Exemplo de imagem em grayscale: Add Grayscale

Opacidade

Defina a opacidade da imagem. Valor numérico entre 0 e 1. Exemplo de JSON de opacidade:
Opacity

Quality

Para imagens JPG ou JPEG, especifique a qualidade, ou quantidade de compressão, da imagem. Quanto menor o número, maior a compressão, porém menor a qualidade da imagem. Quanto maior o número, menor a compressão, porém maior a qualidade da imagem. Valor numérico entre 0 e 100. Exemplo de JSON de quality:
Quality

Converter para JPG ou WebP

As opções convertToJpg e convertToWebP permitem transformar imagens do seu formato original (como PNG) para o formato JPG ou WebP, respectivamente. Por padrão, as imagens convertidas terão qualidade de 75%. Você pode personalizar o nível de compressão usando o parâmetro quality no objeto effects. Observe que, se sua imagem de origem já for um JPG e você usar convertToJpg, a API simplesmente redimensionará a imagem para as dimensões especificadas sem alterar o formato. Exemplo de conversão para JPG:
Convert to JPG
Exemplo de conversão para WebP:
Convert to WebP