convertajá

API · Imagem

Imagem para redes sociais e marketplace via API

Deixe a foto no tamanho certo para Instagram, Facebook, WhatsApp, YouTube, LinkedIn, Mercado Livre e Shopee. Integre no seu sistema com uma chamada: POST /v1/tools/imagem-redes-sociais.

Custo1 crédito por arquivo
TipoLeve
Arquivos1 ou mais
Formatosjpg, jpeg, png, webp, gif, tif, tiff, bmp…

Exemplo

curl -X POST "https://convertaja.com.br/v1/tools/imagem-redes-sociais?wait=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "files=@arquivo1.jpg" \
  -F 'options={"preset":"ig-portrait","fit":"contain"}'

Opções

Envie em options (JSON) ou como campos do formulário. Opções desconhecidas são recusadas com 400 invalid_option.

OpçãoTipoDescrição e valoresPadrão
presetstringFormato
ig-post Instagram: post quadrado (1080×1080) · ig-portrait Instagram: post retrato (1080×1350) · story Story, Reels e Status (1080×1920) · fb-post Facebook: post (1200×630) · fb-cover Facebook: capa (1640×624) · wa-profile WhatsApp e redes: foto de perfil (640×640) · yt-thumb YouTube: miniatura (1280×720) · li-banner LinkedIn: capa (1584×396) · marketplace Mercado Livre e Shopee: produto (1200×1200, fundo branco)
"ig-post"
fitstringAjuste
cover Cortar para preencher · contain Mostrar inteira (com fundo)
"cover"
bgstringFundo
blur Desfocado · white Branco · black Preto
Usada só em algumas combinações de opções.
"blur"

Com arquivo por URL (JSON)

curl -X POST "https://convertaja.com.br/v1/tools/imagem-redes-sociais" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"files":[{"url":"https://seusite.com.br/arquivos/exemplo1.jpg"}],"options":{"preset":"ig-portrait","fit":"contain"},"webhook_url":"https://seusite.com.br/webhooks/convertaja"}'

Resposta

202 com a tarefa (ou 200 já concluída, com ?wait=true). Baixe em outputs[].url ou em download_url (ZIP quando há vários arquivos). Os arquivos ficam disponíveis por 1 hora. Se a tarefa falhar, os crédito volta para o seu saldo.

{
  "id": "V1StGXR8_Z5j",
  "tool": "imagem-redes-sociais",
  "status": "running",
  "progress": 0,
  "credits_charged": 1,
  "outputs": []
}

Prefere sem programar? Use Imagem para redes sociais e marketplace no site.

Outras ferramentas de Imagem