Herramientas de GIF

Redimensiona, optimiza, cambia la velocidad, invierte, extrae fotogramas y gira GIF animados. Ofrece varios modos de operación en una sola herramienta.

Endpoint de la API

POST /api/v1/tools/image/gif-tools

Parámetros

Parámetros comunes

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
mode	string	No	"resize"	Modo de operación: resize, optimize, speed, reverse, extract, rotate
loop	number	No	0	Número de repeticiones del GIF de salida (0 = infinito, 1-100 = repeticiones finitas)

Parámetros del modo Redimensionar

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
width	integer	No	-	Ancho objetivo en píxeles (1 a 16384)
height	integer	No	-	Alto objetivo en píxeles (1 a 16384)
percentage	number	No	-	Escalar por porcentaje (1 a 500). Anula width/height si se define.

Parámetros del modo Optimizar

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
colors	number	No	256	Número máximo de colores en la paleta (2 a 256)
dither	number	No	1.0	Intensidad del difuminado (0 a 1, donde 0 desactiva el difuminado)
effort	number	No	7	Nivel de esfuerzo de optimización (1 a 10, mayor = más lento pero más pequeño)

Parámetros del modo Velocidad

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
speedFactor	number	No	1.0	Multiplicador de velocidad (0.1 a 10). Los valores > 1 aceleran, < 1 ralentizan.

Parámetros del modo Extraer

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
extractMode	string	No	"single"	Modo de extracción: single, range, all
frameNumber	number	No	0	Índice del fotograma a extraer en el modo single (basado en 0)
frameStart	number	No	0	Índice del fotograma inicial para el modo range (basado en 0)
frameEnd	number	No	-	Índice del fotograma final para el modo range (basado en 0, inclusive)
extractFormat	string	No	"png"	Formato de los fotogramas extraídos: png, webp

Parámetros del modo Girar

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
angle	number	No	-	Ángulo de rotación: 90, 180 o 270 grados
flipH	boolean	No	false	Voltear horizontalmente
flipV	boolean	No	false	Voltear verticalmente

Ejemplos de solicitud

Redimensionar

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "[email protected]" \
  -F 'settings={"mode":"resize","percentage":50}'

Optimizar

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "[email protected]" \
  -F 'settings={"mode":"optimize","colors":128,"effort":9}'

Acelerar

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "[email protected]" \
  -F 'settings={"mode":"speed","speedFactor":2.0}'

Extraer un solo fotograma

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "[email protected]" \
  -F 'settings={"mode":"extract","extractMode":"single","frameNumber":5,"extractFormat":"png"}'

Ejemplo de respuesta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/animation.gif",
  "originalSize": 2345678,
  "processedSize": 1234567
}

Subruta de información

POST /api/v1/tools/image/gif-tools/info

Devuelve metadatos sobre un GIF animado sin procesarlo.

Solicitud de información

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools/info \
  -F "[email protected]"

Respuesta de información

{
  "width": 480,
  "height": 320,
  "pages": 24,
  "delay": [100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100],
  "loop": 0,
  "fileSize": 2345678,
  "duration": 2400
}

Notas

• Usa la fábrica estándar createToolRoute para el endpoint de procesamiento principal.
• El endpoint de información solo requiere subir un archivo (no se necesita configuración).
• En el modo resize, si se proporciona percentage tiene prioridad sobre width/height. El redimensionado usa fit: inside para mantener la relación de aspecto.
• En el modo speed, los retardos de los fotogramas se dividen por el factor de velocidad. El retardo mínimo por fotograma es de 20 ms (limitación de la especificación GIF).
• En el modo reverse, el parámetro speedFactor también está disponible para ajustar simultáneamente la velocidad mientras se invierte.
• En el modo extract con range o all, la salida es un archivo ZIP que contiene fotogramas individuales.
• En el modo rotate, cada fotograma se procesa individualmente y se vuelve a ensamblar en una animación.
• El parámetro loop controla cuántas veces se repite el GIF de salida. Usa 0 para repetición infinita.
• El campo duration de la respuesta de información es la duración total de la animación en milisegundos.