API de embelezamento com IA

A API de embelezamento com IA do Photoroom melhora a qualidade do elemento principal em fotos de produtos ou alimentos, criando imagens mais atraentes — de um único upload a um catálogo inteiro.

Ao contrário de um filtro de imagem genérico, ele tem modos pensados para o que você vende: ai.auto para um resultado com o visual de uma foto de produto em estúdio, ai.food para alimentos e ai.car para carros. É uma das mais de 20 edições da Photoroom API.

A API AI Beautifier da Photoroom faz isso dentro do seu próprio fluxo de upload: cada foto enviada por um vendedor é aprimorada assim que chega, sem que seja preciso mudar a forma de fotografar ou enviar as imagens. A API processa uma imagem por chamada, e as chamadas podem ser executadas em paralelo, até o limite de requisições (60 imagens por minuto por padrão, com um limite maior no Enterprise).

Você pode combinar com Posicionamento, Sombras IA ou Fundos IA na mesma chamada.

Para imagens de comida, a API AI Beautifier do Photoroom tem um modo específico. Defina beautify.mode como ai.food para obter resultados adaptados às particularidades desse tipo de imagem, como colocar o alimento em um prato.

Plataformas de delivery de comida e aplicativos de supermercado podem enviar um cardápio ou catálogo inteiro por meio dela, uma imagem por chamada, com chamadas em paralelo até o limite de requisições.

Para isso, consulte o QA visual da Photoroom, não o AI Beautifier: o AI Beautifier melhora uma foto, mas não atribui uma pontuação nem a filtra. O QA visual está disponível nos planos Enterprise e também é oferecido como produto de API independente.

Os planos Enterprise podem combinar QA visual com o Embelezador com IA e outras edições em um fluxo de trabalho do Visual Agents. Fale com a equipe de vendas para configurar tudo.

O AI Beautifier está incluído no plano Plus da API, por US$ 100 por mês (US$ 0,10 por imagem), e nos planos Enterprise. Uma chamada custa o mesmo, independentemente das edições que combinar. Assim, embelezar e adicionar uma sombra em uma única chamada custa o mesmo que apenas embelezar, e chamadas que retornam um erro não consomem uma imagem.

Você pode testar primeiro no modo sandbox, com 1.000 chamadas gratuitas com marca-d'água por mês na API de edição de imagens. Para planos Enterprise, fale com a equipe de vendas. Confira os detalhes na página de preços.

Obtenha sua chave de API, depois envie sua foto com beautify.mode definido como ai.auto:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form beautify.mode=ai.auto \
  --output result-ai-beautifier.png

Para fotos de comida, use beautify.mode=ai.food. Todos os parâmetros estão na documentação do Embelezador com IA.

• beautify.mode (obrigatório): ai.auto para um resultado com o visual estético de um packshot de produto, ai.food para imagens de comida ou ai.car para imagens de carros, por exemplo, para remover reflexos indesejados.

• beautify.seed (opcional): qualquer número inteiro positivo. Com uma seed fixa, a API gera um assunto embelezado com aparência semelhante para a mesma imagem. Sem uma seed, cada chamada gera um resultado diferente.

O Embelezador com IA cria uma nova versão visual do assunto principal, permitindo fazer alterações. Compare os resultados com os originais e consulte a documentação para ver exemplos.

Envie arquivos PNG, JPEG, WEBP ou AVIF de até 30 MB e com no máximo 5.000 pixels no lado mais largo e receba arquivos nos mesmos formatos. Por padrão, o Embelezador com IA gera resultados com resolução de 1K (1024x1024). As resoluções de 2K e 4K estão disponíveis nos planos Enterprise. Confira os detalhes na página de documentação sobre tamanho do arquivo, resolução e formato.

Sim. O Photoroom tem um servidor MCP para assistentes de IA, como o Claude: veja Photoroom MCP para saber quais ferramentas ele oferece.

Para incorporar o AI Beautifier ao seu próprio produto, agentes de programação com IA, como o Claude Code, são uma forma rápida de integrar a API da Photoroom: basta descrever o resultado desejado, e o agente escreve, executa e depura o código para você. A documentação inclui um prompt pronto.

Está com dificuldades para usar a API? Participe da comunidade da API para receber ajuda dos nossos engenheiros ou consulte a página de solução de problemas para conferir problemas comuns.

Para assuntos relacionados a cobranças ou que envolvam informações confidenciais, mande uma mensagem privada diretamente para a Photoroom na comunidade. Estamos sempre à disposição para ajudar.