POST /image-tune/inpaint/v2

Propósito

Este endpoint cambia naturalmente partes específicas de una imagen usando IA. Modifica áreas especificadas en la imagen subida basándose en el prompt para producir el resultado deseado.

Método y Ruta

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

Autenticación

Este endpoint requiere autenticación Bearer Token. Consulta la guía de autenticación para más detalles.

Encabezados Requeridos:

Authorization: Bearer {your_api_key}

Campos de Solicitud

Form Data (multipart/form-data)

Nombre del Campo	Tipo	Requerido	Descripción
image	file	Requerido	Archivo de imagen original para inpainting (PNG, JPG, JPEG, etc.)
prompt	string	Requerido	Prompt de texto describiendo qué hacer inpaint
quality	string	Requerido	Nivel de calidad. Valores permitidos: standard, pro

Guías de Prompt

• Describe específicamente el área a hacer inpaint y el resultado deseado
• Ej: "Cambiar el fondo a cielo azul", "Eliminar el objeto en la esquina superior derecha"

Respuesta

JobIdResponse

Nombre del Campo	Tipo	Descripción
job_id	UUID	Identificador único del trabajo creado. Usa este ID para consultar el estado del trabajo

Reglas de Error / Validación

Código HTTP	Situación de Error	Descripción
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	Fallo de autenticación	Clave de API inválida o encabezado de autenticación faltante
404 Not Found	Usuario no encontrado	No se puede encontrar el usuario vinculado a la clave de API
422 Unprocessable Entity	Fallo de validación	Campo requerido faltante

Comportamiento de Trabajos Asíncronos

Este endpoint se procesa de forma asíncrona. Devuelve inmediatamente un job_id, y el procesamiento real de inpaint ocurre en segundo plano.

Flujo del Trabajo:

1. Envía el archivo de imagen y el prompt, y se devuelve inmediatamente un job_id
2. El procesamiento de inpaint ocurre en segundo plano
3. Haz polling al endpoint GET /job/{job_id} para verificar el estado
4. Cuando status cambia a Succeed, consulta la URL de la imagen resultante en image_urls

Intervalo de Polling: Se recomienda 1-2 segundos

Ejemplo de Solicitud

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=Cambiar el fondo a cielo azul" \
-F "quality=standard"

Ejemplo de Respuesta

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