Ridimensionare un'immagine: calcolo di larghezza e altezza
Ridimensionare un’immagine alle dimensioni desiderate calcola la misura in pixel dopo il ridimensionamento.
Esegui gratis nel browser
Inserisca larghezza e altezza originali, quindi una larghezza di destinazione, un’altezza di destinazione oppure entrambe. Se indica una sola dimensione di destinazione, il calcolatore ricava l’altra dalle proporzioni originali e la arrotonda al pixel intero più vicino. Se le indica entrambe, restituisce esattamente quei valori. Il risultato è deterministico ed è utile per pipeline di immagini, layout adattivi, convalida dei caricamenti e generazione di comandi, senza caricare o decodificare alcuna immagine.
Calcoli una misura proporzionale da un solo valore
Inizi dalla larghezza e dall’altezza in pixel dell’immagine sorgente. Inserisca poi target_width oppure target_height. Il calcolatore divide la dimensione di destinazione scelta per la corrispondente dimensione originale, ottenendo il fattore di scala; applica tale fattore all’altro lato e arrotonda il risultato al pixel intero più vicino. Per esempio, un’immagine di 1920 per 1080 ridimensionata a una larghezza di 1280 diventa 1280 per 720. Questo metodo conserva le proporzioni della sorgente con la massima precisione consentita dai pixel interi, quindi i cerchi restano circolari e i soggetti non appaiono allungati. È particolarmente utile quando un layout fissa un asse e lascia adattare l’altro, come una colonna di blog a larghezza fissa o una galleria con righe di altezza fissa. Lo strumento calcola soltanto le dimensioni: non carica, decodifica, ricampiona, ritaglia, comprime né modifica l’immagine. Lei può passare larghezza e altezza restituite a una libreria grafica, a un programma da riga di comando, a una pipeline di contenuti o a una regola di rendering del browser.
Usi entrambe le misure quando serve un riquadro esatto
Inserisca sia target_width sia target_height quando la destinazione richiede un riquadro dalle misure esatte in pixel. In questa modalità, il calcolatore restituisce direttamente i due valori richiesti. Non modifica di nascosto alcun valore per conservare le proporzioni originali, perché ciò contraddirebbe le dimensioni che Lei ha indicato esplicitamente. Questa distinzione è importante per spazi pubblicitari, schede di marketplace, modelli di stampa, schermi e sistemi meno recenti che accettano solo una tela fissa. Se il rapporto di destinazione differisce da quello sorgente, un elaboratore dovrà scegliere il passaggio successivo: allungare l’immagine, ritagliarla per riempire il riquadro oppure adattarla lasciando spazio vuoto. Questa capacità non prende intenzionalmente tale decisione visiva. Fornisce invece dimensioni chiare e prevedibili che il codice successivo può usare con una strategia esplicita. Confronti i rapporti prima di allungare fotografie, loghi, diagrammi, illustrazioni o testi, perché altrimenti potrebbe prodursi una distorsione visibile.
Gestisca pixel, arrotondamento e convalida in modo affidabile
Tutte e quattro le dimensioni sono numeri interi positivi, perché le immagini raster sono misurate in pixel interi. Larghezza e altezza originali sono sempre obbligatorie e deve essere presente almeno una dimensione di destinazione. Zeri, valori negativi, frazioni, dati non numerici e dimensioni superiori al limite pubblicato di un miliardo di pixel vengono rifiutati invece di essere convertiti. Con un solo valore di destinazione, il lato calcolato usa il normale arrotondamento all’intero più vicino e non scende mai sotto un pixel. Per immagini molto piccole, l’arrotondamento può rendere il rapporto restituito leggermente diverso da quello matematico: è inevitabile, poiché non esistono frazioni di pixel. Per un’automazione ripetibile, invii le dimensioni originali riportate nei metadati dell’immagine, non le dimensioni CSS di visualizzazione o una stima manuale. Lo stesso input produce sempre lo stesso output: non intervengono rete, casualità, ora corrente, analisi del file o stato nascosto. Il risultato si può quindi memorizzare nella cache, verificare con fixture golden e riutilizzare nei client API e nei flussi del browser.
Casi d'uso
Preparare larghezze adattive
Calcoli l’altezza corrispondente per ogni larghezza fissa prima di generare le varianti dell’immagine.
Convalidare una misura di consegna esatta
Determini il riquadro richiesto per uno spazio pubblicitario, una scheda commerciale o uno schermo.
Creare comandi di ridimensionamento
Converta i metadati sorgente e un lato richiesto in dimensioni intere per una pipeline grafica.
Domande frequenti
Che cosa accade se indico solo una larghezza di destinazione?
L’altezza viene calcolata dalle proporzioni originali e arrotondata al pixel intero più vicino.
Che cosa accade se indico solo un’altezza di destinazione?
La larghezza viene calcolata dalle proporzioni originali e arrotondata al pixel intero più vicino.
Posso indicare entrambe le dimensioni di destinazione?
Sì. Entrambi i valori vengono restituiti esattamente, anche se il rapporto differisce da quello originale.
Questo strumento carica o ridimensiona la mia immagine?
No. Esegue solo calcoli dimensionali e non riceve, decodifica, conserva o modifica mai i dati dell’immagine.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/image/resize-to-dimensions \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"width":1920,"height":1080,"target_width":1280}'const res = await fetch("https://api.kit.forhosting.com/image/resize-to-dimensions", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"width": 1920,
"height": 1080,
"target_width": 1280
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/resize-to-dimensions",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"width": 1920,
"height": 1080,
"target_width": 1280
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/resize-to-dimensions", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"width":1920,"height":1080,"target_width":1280}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"width":1920,"height":1080,"target_width":1280}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/resize-to-dimensions", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"width": 1920,
"height": 1080,
"target_width": 1280
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.resize_to_dimensions",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 15 |
max_megapixels | 12 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |