POST /image-tune/inpaint/v1

Propósito

Este endpoint modifica naturalmente partes específicas de uma imagem usando IA. Ele altera as áreas indicadas com base na imagem enviada e no prompt para produzir o resultado desejado. É o mesmo recurso da aba V1 da página "Repintar imagem" do web app (o web app abre na aba V2 por padrão).

Custo em créditos: 5

Método e Caminho

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

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 a repintar (PNG ou JPEG)
prompt	string	Obrigatório	Prompt de texto descrevendo o que deve ser repintado

Diretrizes de Prompt

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

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 repintura 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 repintura 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/v1" \
-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"
}