POST /image-tune/inpaint/v1

Propósito

Este endpoint modifica de forma natural partes específicas de una imagen usando IA. Modifica las áreas indicadas basándose en la imagen subida y el prompt para producir el resultado deseado. Es la misma función que la pestaña V1 de la página "Repintar imagen" de la aplicación web (la aplicación web se abre por defecto en la pestaña V2).

Costo en créditos: 5

Método y Ruta

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

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 a repintar (PNG o JPEG)
prompt	string	Requerido	Prompt de texto describiendo qué repintar

Guías de Prompt

• Describe en detalle el área a repintar y el resultado deseado
• Ejemplos: "Change background to blue sky", "Remove object in upper right corner"

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 repintado 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 repintado 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/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Change background to blue sky"

Ejemplo de Respuesta

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