Suporte a imagem de entrada
Use URLs de imagem hospedadas no campo JSON image; uploads locais e base64 não são suportados nesta rota.
API de edição de imagens com IA
API de edição de imagens com IA para fluxos de produto
Use uma API para transformar imagens de referência, criar variações de produto, aplicar mudanças de estilo e construir recursos de edição com modelos Gemini e GPT suportados.
Imagens de referênciaEdições por promptFluxos com múltiplas saídas
Requisição de edição de imagem
Envie uma imagem de entrada e instruções de prompt para um modelo de edição.
curl https://api.pixapi.ai/v1/images/edits \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"image": "https://cdn.example.com/product.png",
"prompt": "Place the product in a clean studio scene",
"n": 1,
"size": "1:1"
}'Resposta direta: como funciona a edição de imagens no Pixapi
A edição de imagens usa POST /v1/images/edits para edições síncronas e POST /v1/async/images/edits quando a edição deve rodar como tarefa.
A requisição mantém a chave no servidor e envia campos JSON como model, image URL, prompt, n e size para um modelo com suporte a edição.
Use o endpoint para troca de fundo, variações de produto, edições guiadas por referência e uploads em que o app precisa rastrear request ids e créditos.
Construa edição de imagem sem código de cola por provedor
Cargas de edição precisam de validação, tratamento de ativos, retentativas e cobrança mais claros do que demos isoladas.
Edições controladas por prompt
Crie fluxos para fotografia de produto, troca de fundo, transferência de estilo e variações criativas.
Razão de créditos compartilhado
Use o mesmo modelo de cobrança para geração e edição, facilitando previsão de custo visual.
Observabilidade de produção
Registre request ids e model ids para investigar edições com falha ou rejeitadas.
Estratégia de fallback de modelo
Compare rotas Gemini e GPT mantendo o contrato de API familiar.
Integração com segurança primeiro
Mantenha uploads de usuários e chaves do Pixapi no servidor, sem expor credenciais.
Casos de uso de edição de imagens
| Fluxo | Rota de modelo no Pixapi | Nota de implementação |
|---|---|---|
| Troca de fundo | Edição de imagem Gemini | Envie a imagem de origem com um prompt de cena conciso. |
| Variações de produto | Rota Gemini ou GPT Image | Salve request id e modelo escolhido para auditoria. |
| Redimensionamento criativo | Rota de geração ou edição | Escolha proporção e número de saídas por canal. |
| Edição de uploads de usuário | Chamada Pixapi apenas no backend | Valide arquivos e mantenha chaves fora do navegador. |
Recursos relacionados à integração
Documentação da API
Consulte endpoints, autenticação, campos de solicitação e respostas.
Guia de autenticação
Crie e proteja uma chave bearer antes das chamadas de produção.
Catálogo de modelos
Compare modelos de imagem e vídeo por capacidade e custo.
Créditos e preços
Consulte pacotes de créditos, regras de cobrança e preços atuais.
FAQ da API de edição de imagens
O Pixapi pode editar imagens existentes?
Sim. Modelos suportados podem receber uma imagem de entrada e instruções de prompt pelo endpoint de edição.
A edição consome créditos como geração?
A edição consome créditos conforme o modelo e as configurações de saída. Consulte as páginas de modelo e preços ao vivo.
Posso pedir várias saídas editadas?
Rotas suportadas podem retornar várias saídas. Use o parâmetro de quantidade documentado para o modelo escolhido.
Onde devo tratar uploads?
Trate uploads no seu backend ou camada de armazenamento confiável e passe URLs hospedadas validadas para o Pixapi.
Adicione edição com IA ao fluxo do produto
Use uma chave Pixapi para edição por referência, texto para imagem e futuras rotas de modelos visuais.
Criar chave de API