Repintar V2

Propósito

Redesenha parte de uma imagem com IA com base em um prompt. Envie a imagem e descreva o que deve ser redesenhado. É o mesmo recurso da aba V2 da página "Repintar imagem" do web app (a aba padrão).

Custo em créditos: 3

Método e Caminho

POST /public/v1/image-tune/inpaint/v2

Autenticação

Consulte a página de Autenticação. É necessário um token Bearer.

Cabeçalhos Obrigatórios:

Authorization: Bearer {your_api_key}

Campos da Requisição

Envie a requisição como multipart/form-data.

Nome do Campo	Tipo	Obrigatório	Descrição
image	file	Sim	Arquivo de imagem original a repintar (PNG ou JPEG)
prompt	string	Sim	Qual parte deve ser redesenhada? O prompt é enviado como está

Diretrizes de prompt

• Descreva em detalhes a área a redesenhar e o resultado desejado
• Exemplos: "Change background to blue sky", "Remove object in upper right corner"

Resposta

Resposta de Sucesso (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descrição
job_id	string	Identificador único do job criado. Use Obter Status do Job para consultar os resultados

Regras de Erro / Validação

Situação	Status HTTP	Mensagem de Erro
A imagem não é um arquivo PNG ou JPEG válido	400	"Invalid image file"
Chave de API inválida	401	"Invalid API key"
Campo ausente	422	Erro de validação

Comportamento do Job Assíncrono

Este endpoint cria um job assíncrono. Ele retorna imediatamente um job_id, e a repintura é executada em segundo plano.

Método de Polling:

1. Salve o job_id recebido na resposta
2. Faça polling em GET /public/v1/job/{job_id} para verificar o status
3. Quando o status se tornar Succeed, verifique a imagem resultante em image_urls

Fluxo de Status: Pending → Succeed ou Failed

Exemplo de Requisição

cURL:

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Change background to blue sky"

Exemplo de Resposta:

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}