Repintar V2

Propósito

Redibuja parte de una imagen con IA a partir de un prompt. Sube la imagen y describe qué debe redibujarse. Es la misma función que la pestaña V2 de la página "Repintar imagen" de la aplicación web (la pestaña por defecto).

Costo en créditos: 3

Método y Ruta

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

Autenticación

Consulta la página de autenticación. Se requiere un token Bearer.

Encabezados Requeridos:

Authorization: Bearer {your_api_key}

Campos de Solicitud

Envía la solicitud como multipart/form-data.

Nombre del Campo	Tipo	Requerido	Descripción
image	file	Sí	Archivo de imagen original a repintar (PNG o JPEG)
prompt	string	Sí	¿Qué parte debería redibujarse? El prompt se envía tal cual

Guías de prompt

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

Respuesta

Respuesta Exitosa (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descripción
job_id	string	Identificador único del trabajo creado. Consulta los resultados con Get Job Status

Reglas de Error / Validación

Situación	Estado HTTP	Mensaje de Error
La imagen no es un archivo PNG o JPEG válido	400	"Invalid image file"
Clave de API inválida	401	"Invalid API key"
Campo faltante	422	Error de validación

Comportamiento de Trabajos Asíncronos

Este endpoint crea un trabajo asíncrono. Devuelve inmediatamente un job_id, y el repintado se ejecuta en segundo plano.

Método de Polling:

1. Guarda el job_id recibido en la respuesta
2. Haz polling a GET /public/v1/job/{job_id} para verificar el estado
3. Cuando el estado sea Succeed, consulta la imagen resultante en image_urls

Flujo de Estado: Pending → Succeed o Failed

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=Change background to blue sky"

Ejemplo de Respuesta:

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