Ingrandire un’immagine
Questo endpoint prende un'immagine e la ricampiona verso dimensioni in pixel maggiori, per quando un file piccolo deve stare in un layout pensato per uno più grande.
Questa attività non è disponibile al momento, quindi non può essere acquistata. Non viene addebitato nulla.
Vedi l'APIÈ un ingrandimento normale di buona qualità, non un upscaler che ricostruisce il dettaglio: non aggiunge informazione che non fosse nell'originale, quindi una foto ingrandita appare più morbida di una scattata a quella dimensione. Al momento non è disponibile e non accetta lavori; la nota qui sotto spiega perché, e l'endpoint e il prezzo mostrati qui sono quelli che userebbe se tornasse.
Cosa può e cosa non può fare un ingrandimento normale
Ingrandire un'immagine significa ricampionarla: i pixel esistenti vengono distribuiti su una tela più grande e i vuoti sono riempiti per interpolazione. Basta per far raggiungere a un'immagine piccola una dimensione richiesta, ma l'interpolazione non può aggiungere informazione che la sorgente non ha mai registrato. I bordi fini si ammorbidiscono, il testo piccolo si sfoca e la texture si appiattisce man mano che il fattore cresce: un ingrandimento 4x lo mostra più di uno 2x. Qualsiasi strumento che dica di 'ripristinare' un dettaglio perduto sta descrivendo un modello più pesante, basato su GPU, che questo endpoint non esegue.
Perché questo strumento ora non è disponibile
Un ingranditore che ricostruisce davvero il dettaglio richiede un modello neurale di super-risoluzione, e questi hanno bisogno di una GPU per girare a un costo ragionevole. La piattaforma dietro questo endpoint offre solo CPU, perciò la versione onesta di questo strumento — una che non promette più di quanto un ricampionamento su CPU possa dare — è ancora in rilavorazione. Fino ad allora l'endpoint non accetta lavori, e non viene addebitato nulla per un'attività che non può essere eseguita.
Quando un ingrandimento normale è ancora utile
Ricampionare a una dimensione maggiore ha usi reali anche senza dettaglio aggiunto: raggiungere le dimensioni minime in pixel di un modello, stampare una piccola grafica a una dimensione fisica fissa, o uniformare un insieme misto di immagini a una sola risoluzione. In ogni caso il valore sta nel cambio di dimensione, non in una nitidezza nuova: il risultato somiglierà all'originale a scala maggiore, che per molti lavori di impaginazione e stampa è esattamente ciò che serve.
Formati e come funzionerebbe
I formati raster comuni sarebbero accettati in ingresso, e sceglieresti il formato di uscita. Al suo ritorno, lo strumento funzionerebbe in modo asincrono: invia l'immagine e un fattore obiettivo, ricevi un task_id e ottieni il file ingrandito tramite link firmato appena è pronto — utile quando l'ingrandimento è una fase di un lavoro più grande, come preparare un catalogo eterogeneo a una dimensione minima comune.
Casi d'uso
Raggiungere la dimensione minima di un modello
Un modello di scheda richiede una dimensione minima in pixel e un'immagine sorgente più piccola viene ingrandita per adattarsi, accettando che il risultato sia più morbido anziché più nitido.
Stampa a dimensione fissa
Un piccolo logo o una grafica viene ingrandito alle dimensioni in pixel che un layout di stampa si aspetta per una data dimensione fisica.
Uniformare un insieme misto
Un lotto di immagini di dimensioni diverse viene ricampionato a una sola risoluzione comune prima dell'impaginazione, senza pretendere di aggiungere dettaglio.
Riempire una cornice più grande
Un piccolo avatar viene ingrandito per riutilizzarlo in una cornice più grande nei casi in cui un risultato più morbido è accettabile.
Domande frequenti
Come ingrandirei un'immagine con l'api?
Questo strumento non è ancora disponibile. Al suo ritorno faresti un POST su /image/upscale con l'immagine sorgente e un fattore obiettivo, 2x o 4x, e riceveresti un task_id insieme all'immagine ingrandita per webhook o link firmato.
Qual è la differenza tra 2x e 4x?
2x raddoppia larghezza e altezza, 4x le quadruplica. Poiché un ingrandimento normale non può aggiungere dettaglio, più alto è il fattore più morbido appare il risultato.
Rende nitida una foto sfocata?
No. Un ingrandimento normale ricampiona l'immagine a una dimensione maggiore; non può recuperare dettaglio mai catturato, quindi una sorgente sfocata o molto compressa resta morbida: più grande, non più nitida.
C'è un piano gratuito per l'api di ingrandimento immagine?
Non c'è un piano gratuito — i piani gratuiti vengono abusati e rallentano tutti. L'accesso funziona con un saldo ForHosting KIT prepagato: lo ricarichi a partire da $10.00 (non scade) e ogni richiesta è addebitata al prezzo pubblicato, così una chiamata senza saldo restituisce HTTP 402. Nessun abbonamento, nessun token né crediti inventati, e un'attività fallita non viene mai addebitata.
Quanto costa ingrandire un'immagine?
$0.061 a richiesta più $0.0041 per immagine, e vengono addebitate solo le attività completate.
L'api di ingrandimento immagine è già attiva?
No. È ritirata temporaneamente mentre viene rifatta perché non prometta un dettaglio che un ricampionamento su CPU non può dare. L'endpoint e il prezzo mostrati qui sono quelli che userebbe se tornasse.
Quali formati di immagine potrei ingrandire?
I formati raster comuni sarebbero accettati in ingresso, e sceglieresti il formato di uscita per il risultato ingrandito.
Potrei ingrandire un grande lotto di immagini in una volta?
Sì, combineresti questo endpoint con l'API di Elaborazione in Lotto per ingrandire molte immagini in una sola chiamata, ciascuna quotata separatamente.
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
One authenticated POST creates the task; the result comes back by webhook or a signed link. This capability is currently available through the API, not as an interactive Web tool.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/image/upscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://example.com/photo.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/upscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://example.com/photo.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/upscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://example.com/photo.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/upscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://example.com/photo.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://example.com/photo.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/upscale", 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
{
"image": "https://example.com/photo.jpg"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.upscale",
"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. |
501 | coming_soon | Questo strumento non è ancora attivo via API: arriva presto. |