Strumenti GIF

Ridimensiona, ottimizza, cambia velocità, inverti, estrai fotogrammi e ruota GIF animate. Offre più modalità operative in un unico strumento.

Endpoint API

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

Parametri

Parametri Comuni

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
mode	string	No	"resize"	Modalità operativa: resize, optimize, speed, reverse, extract, rotate
loop	number	No	0	Numero di ripetizioni per la GIF di output (0 = infinito, 1-100 = ripetizioni finite)

Parametri della Modalità Resize

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
width	integer	No	-	Larghezza target in pixel (da 1 a 16384)
height	integer	No	-	Altezza target in pixel (da 1 a 16384)
percentage	number	No	-	Scala per percentuale (da 1 a 500). Sovrascrive width/height se impostato.

Parametri della Modalità Optimize

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
colors	number	No	256	Numero massimo di colori nella palette (da 2 a 256)
dither	number	No	1.0	Intensità del dithering (da 0 a 1, dove 0 disabilita il dithering)
effort	number	No	7	Livello di impegno dell'ottimizzazione (da 1 a 10, più alto = più lento ma più piccolo)

Parametri della Modalità Speed

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
speedFactor	number	No	1.0	Moltiplicatore di velocità (da 0.1 a 10). Valori > 1 accelerano, < 1 rallentano.

Parametri della Modalità Extract

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
extractMode	string	No	"single"	Modalità di estrazione: single, range, all
frameNumber	number	No	0	Indice del fotogramma da estrarre in modalità single (in base 0)
frameStart	number	No	0	Indice del fotogramma iniziale per la modalità range (in base 0)
frameEnd	number	No	-	Indice del fotogramma finale per la modalità range (in base 0, incluso)
extractFormat	string	No	"png"	Formato per i fotogrammi estratti: png, webp

Parametri della Modalità Rotate

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
angle	number	No	-	Angolo di rotazione: 90, 180 o 270 gradi
flipH	boolean	No	false	Capovolgi orizzontalmente
flipV	boolean	No	false	Capovolgi verticalmente

Richieste di Esempio

Resize

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

Optimize

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

Speed Up

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

Estrai Singolo Fotogramma

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"}'

Risposta di Esempio

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

Sotto-rotta Info

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

Restituisce i metadati di una GIF animata senza elaborarla.

Richiesta Info

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

Risposta Info

{
  "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
}

Note

• Usa la factory createToolRoute standard per l'endpoint di elaborazione principale.
• L'endpoint info richiede solo il caricamento di un file (nessuna impostazione necessaria).
• In modalità resize, se viene fornito percentage ha la priorità su width/height. Il ridimensionamento usa fit: inside per mantenere le proporzioni.
• In modalità speed, i ritardi dei fotogrammi vengono divisi per il fattore di velocità. Il ritardo minimo per fotogramma è di 20ms (limitazione delle specifiche GIF).
• In modalità reverse, è disponibile anche il parametro speedFactor per regolare simultaneamente la velocità durante l'inversione.
• In modalità extract con range o all, l'output è un file ZIP contenente i singoli fotogrammi.
• In modalità rotate, ogni fotogramma viene elaborato individualmente e riassemblato in un'animazione.
• Il parametro loop controlla quante volte la GIF di output viene ripetuta. Usa 0 per il loop infinito.
• Il campo duration nella risposta info è la durata totale dell'animazione in millisecondi.