Sprite Plus

Propósito

Genera una animación de sprite a partir de un fotograma inicial y un fotograma final opcional. Es la misma función que la pestaña Plus de la página "Generar sprites" de la aplicación web (Sprite Lite & Plus). Elige el número de fotogramas con frame, exactamente como se muestra en el control deslizante de la página web.

Costo en créditos: 9 (49 fotogramas), 13 (81 fotogramas)

Método y Ruta

POST /public/v1/sprite/plus

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	Por defecto	Descripción
start_image	file	Sí		Fotograma inicial (PNG o JPEG)
end_image	file	No		Fotograma final (opcional) (PNG o JPEG)
text	string	Sí		Prompt que describe el movimiento. Se eliminan los espacios en blanco y el texto no debe estar vacío
frame	integer	Sí		Fotogramas. Valores permitidos: 49, 81
is_pixel	boolean	No	false	Pixel art. Activa esta opción si la imagen adjunta está basada en pixel art
is_prompt_enhancement	boolean	No	true	Mejora del prompt. Refina lo que escribes para que sea más adecuado para generar sprites

Créditos por frame

frame	Créditos
49	9
81	13

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
Alguna de las imágenes no es un archivo PNG o JPEG válido	400	"Invalid image file"
Valor de frame no permitido	400	"frame should be one of 49, 81"
text está vacío	400	"text must not be empty"
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 la generación real del sprite ocurre 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 los resultados en image_urls (hoja de sprites y GIF)

Flujo de Estado: Pending → Succeed o Failed

Ejemplo de Solicitud

cURL (solo fotograma inicial):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/plus" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_image=@/path/to/character.png" \
-F "text=walking animation" \
-F "frame=49" \
-F "is_pixel=true"

cURL (fotograma inicial + final):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/plus" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_image=@/path/to/character_start.png" \
-F "end_image=@/path/to/character_end.png" \
-F "text=running animation cycle" \
-F "frame=81"