POST /image-tune/inpaint/v2

Propósito

Este endpoint altera naturalmente partes específicas de uma imagem usando IA. Com base na imagem enviada e no prompt, ele modifica áreas especificadas para criar o resultado desejado.

Método e Caminho

• HTTP Method: POST
• Path: /public/v1/image-tune/inpaint/v2

Autenticação

Este endpoint requer autenticação Bearer Token. Consulte o Guia de Autenticação para mais detalhes.

Cabeçalhos Obrigatórios:

Authorization: Bearer {your_api_key}

Campos da Requisição

Form Data (multipart/form-data)

Nome do Campo	Tipo	Obrigatório	Descrição
image	file	Obrigatório	Arquivo de imagem original para inpainting (PNG, JPG, JPEG, etc.)
prompt	string	Obrigatório	Prompt de texto descrevendo o que deve ser inpainted
quality	string	Obrigatório	Nível de qualidade. Valores permitidos: standard, pro

Diretrizes de Prompt

• Descreva especificamente a área a ser inpainted e o resultado desejado
• Ex: "Mudar o fundo para céu azul", "Remover o objeto no canto superior direito"

Resposta

JobIdResponse

Nome do Campo	Tipo	Descrição
job_id	UUID	Identificador único do job criado. Use este ID para consultar o status do job

Regras de Erro / Validação

Código HTTP	Situação de Erro	Descrição
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	Falha de autenticação	Chave de API inválida ou cabeçalho de autenticação ausente
404 Not Found	Usuário não encontrado	Usuário vinculado à chave de API não encontrado
422 Unprocessable Entity	Falha de validação	Campo obrigatório ausente

Comportamento do Job Assíncrono

Este endpoint é processado de forma assíncrona. Ele retorna imediatamente um job_id, e o processamento real de inpainting ocorre em segundo plano.

Fluxo do Job:

1. Envie o arquivo de imagem e o prompt para receber imediatamente um job_id
2. O processamento de inpainting ocorre em segundo plano
3. Consulte o status fazendo polling no endpoint GET /job/{job_id}
4. Quando o status mudar para Succeed, verifique a URL da imagem resultante em image_urls

Intervalo de Polling: Recomendado 1-2 segundos

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=Mudar o fundo para céu azul" \
-F "quality=standard"

Exemplo de Resposta

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