API · Imagem

Fotos de produto para marketplace via API

Remova o fundo, deixe branco puro e centralize o produto no tamanho do Mercado Livre, Shopee, Amazon, Magalu ou Shein, em lote. Integre no seu sistema com uma chamada: POST /v1/tools/foto-produto-marketplace.

Custo5 créditos por arquivo

TipoPesada

Arquivos1 ou mais

Formatosjpg, jpeg, png, webp, gif, tif, tiff, bmp…

Exemplo

curl -X POST "https://convertaja.com.br/v1/tools/foto-produto-marketplace?wait=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "files=@arquivo1.jpg" \
  -F 'options={"marketplace":"shopee","background":"remove-transparent"}'

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('files', await openAsBlob('arquivo1.jpg'), 'arquivo1.jpg');
form.append('options', JSON.stringify({"marketplace":"shopee","background":"remove-transparent"}));

const res = await fetch('https://convertaja.com.br/v1/tools/foto-produto-marketplace?wait=true', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
  body: form,
});
const job = await res.json();
console.log(job.status, job.outputs);

import json, os, requests

res = requests.post(
    "https://convertaja.com.br/v1/tools/foto-produto-marketplace",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
    files=[("files", open("arquivo1.jpg", "rb"))],
    data={"options": json.dumps({"marketplace": "shopee", "background": "remove-transparent"})},
)
job = res.json()
print(job["status"], job.get("outputs"))

<?php
$ch = curl_init('https://convertaja.com.br/v1/tools/foto-produto-marketplace?wait=true');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
  CURLOPT_POSTFIELDS => [
    'files[0]' => new CURLFile('arquivo1.jpg'),
    'options' => json_encode(['marketplace' => 'shopee', 'background' => 'remove-transparent']),
  ],
]);
$job = json_decode(curl_exec($ch), true);
echo $job['status'];

Opções

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

Opção	Tipo	Descrição e valores	Padrão
`marketplace`	string	Marketplace `mercado-livre` Mercado Livre (1200×1200) · `shopee` Shopee (1024×1024) · `amazon` Amazon (1600×1600, branco 255) · `magalu` Magalu (1200×1200) · `shein` Shein (1340×1785, 3:4)	`"mercado-livre"`
`background`	string	Fundo `remove-white` Remover: branco · `remove-transparent` Remover: transparente · `keep` Sem remover fundo	`"remove-white"`
`margin`	string	Tamanho do produto no quadro `grande` Grande (92%) · `padrao` Padrão (85%) · `respiro` Com respiro (72%)	`"padrao"`
`format`	string	Formato `jpg` JPG · `png` PNG Usada só em algumas combinações de opções.	`"jpg"`

Com arquivo por URL (JSON)

curl -X POST "https://convertaja.com.br/v1/tools/foto-produto-marketplace" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"files":[{"url":"https://seusite.com.br/arquivos/exemplo1.jpg"}],"options":{"marketplace":"shopee","background":"remove-transparent"},"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éditos voltam para o seu saldo.

{
  "id": "V1StGXR8_Z5j",
  "tool": "foto-produto-marketplace",
  "status": "running",
  "progress": 0,
  "credits_charged": 5,
  "outputs": []
}

Prefere sem programar? Use Fotos de produto para marketplace no site.

Fotos de produto para marketplace via API

Exemplo

Opções

Com arquivo por URL (JSON)

Resposta

Outras ferramentas de Imagem