API de embelezamento com IA

A API de embelezamento com IA da Photoroom melhora a qualidade do elemento principal numa fotografia de produto ou de comida, criando uma imagem mais apelativa, desde uma única imagem carregada até um catálogo inteiro.

Ao contrário de um filtro de imagem genérico, inclui modos concebidos para os produtos que vende: ai.auto para obter um resultado com o aspeto de uma fotografia de produto em estilo packshot, ai.food para comida e ai.car para automóveis. É uma das mais de 20 edições disponíveis através da API da Photoroom.

A API de embelezamento de produtos com IA da Photoroom faz isto no seu próprio fluxo de carregamento: cada fotografia enviada por um vendedor é embelezada assim que chega, sem que os vendedores tenham de alterar a forma como fotografam ou carregam as imagens. A API processa uma imagem por chamada e as chamadas podem ser executadas em paralelo, até ao limite de pedidos (60 imagens por minuto por predefinição, mais no plano Enterprise).

Pode combinar esta opção com Posicionamento, Sombras IA ou Fundos IA na mesma chamada.

Para imagens de comida, a API AI Beautifier da Photoroom tem um modo específico para comida. Defina beautify.mode como ai.food para obter um resultado adaptado às características das imagens de comida, por exemplo, colocando o alimento num prato.

As plataformas de entrega de refeições e as aplicações de supermercado podem enviar um menu ou catálogo completo através da API, uma imagem por chamada, e fazer chamadas em paralelo até ao limite permitido.

Para isso, consulte o QA visual da Photoroom em vez do AI Beautifier: o AI Beautifier melhora uma fotografia, mas não a avalia nem a filtra. O QA visual está disponível nos planos Enterprise e também é vendido como produto de API independente.

Os planos Enterprise podem combinar QA visual com o Embelezador com IA e outras edições num fluxo de trabalho de Visual Agents. Fale com a equipa comercial para configurar esta solução.

O AI Beautifier está incluído no plano Plus da API, por 100 $ por mês (0,10 $ por imagem), e nos planos Enterprise. Cada chamada tem o mesmo custo, independentemente das edições que combina. Por isso, embelezar uma imagem e adicionar-lhe uma sombra numa única chamada custa o mesmo que apenas embelezá-la, e as chamadas que devolvem um erro não consomem créditos de imagem.

Pode começar por testar no modo sandbox, com 1.000 chamadas gratuitas por mês na API de edição de imagens, com resultados com marca de água. Para os planos Enterprise, fale com a equipa comercial. Consulte os detalhes na página de preços.

Obtenha a sua chave de API e, em seguida, envie a 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 fotografias de comida, use beautify.mode=ai.food. Todos os parâmetros estão na documentação do AI Beautifier.

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

• beautify.seed (opcional): qualquer número inteiro positivo. Com um valor de seed fixo, a API produzirá um motivo embelezado com um aspeto semelhante na mesma imagem. Sem esse valor, cada chamada gera um resultado diferente.

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

Envie ficheiros PNG, JPEG, WEBP ou AVIF com até 30 MB e 5 000 píxeis no lado mais comprido para receber ficheiros nos mesmos formatos. Por predefinição, o AI Beautifier gera resultados com uma resolução de 1K (1024x1024). Nos planos Enterprise, estão disponíveis resoluções de saída de 2K e 4K. Consulte a página de documentação sobre tamanho do ficheiro, resolução e formato para mais informações.

Sim. A Photoroom tem um servidor MCP para assistentes de IA, como o Claude: consulte Photoroom MCP para ver que ferramentas inclui.

Para integrar o Embelezador com IA no 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 pretendido e o agente escreve, executa e depura o código por si. A documentação inclui um prompt pronto a usar.

Está com dificuldades com a API? Junte-se à nossa comunidade da API para obter ajuda dos nossos engenheiros ou consulte a página de resolução de problemas para problemas comuns.

Para qualquer assunto relacionado com faturação ou que envolva informações sensíveis, envie uma mensagem privada diretamente à Photoroom na comunidade. Teremos todo o gosto em ajudar.