Introduzione
Cosa fa questo endpoint
Prende un'immagine e restituisce una copia più grande e nitida al livello di dimensione che scegli. Composizione, colori e soggetto restano come li hai inviati, e non c'è prompt.
Gli input che contano
image_url è l'immagine da ingrandire. resolution sceglie il livello: 2k (circa 4 megapixel), 4k (circa 17, predefinito) o 8k (circa 67). Le proporzioni restano, e un livello più basso dell'originale rimpicciolisce l'immagine. output_format imposta il tipo di file: jpeg (predefinito), png o webp.
Cosa ricevi
Un'immagine per richiesta, servita dallo storage della piattaforma quando il task termina.
| Campo | Valore |
|---|---|
| Input | Immagine |
| Output | Immagine |
| Endpoint | Upscale |
| Livelli di dimensione | 2K (~4 MP), 4K (~17 MP), 8K (~67 MP) |
| Proporzioni | Quelle dell'originale |
| Controlli | Nessun prompt: solo livello di dimensione e formato di file |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Un link diretto al file immagine (JPEG, PNG o WebP). Inquadratura e proporzioni passano invariate. almeno 1 caratteri |
resolution | No | 2k (circa 4 MP), 4k (circa 17 MP, predefinito) o 8k (circa 67 MP), con le proporzioni intatte. |
output_format | No | jpeg (predefinito) mantiene file gestibili: circa 8 MB anche al livello più alto nel nostro test. png è senza perdita ma pesa diverse volte di più; webp sta nel mezzo. |
Prezzi
$0.012 / immagine
Addebito per immagine prodotta. Il livello di dimensione e il formato di file non cambiano il prezzo.
Casi d’uso
Render IA in formato stampa
La maggior parte dei modelli di immagine restituisce uno o due megapixel. Con 4k o 8k porti un render a formato poster o stampa senza rigenerarlo e senza perdere la versione che ti piaceva.
Foto prodotto e cataloghi
Ingrandisci un packshot per le viste con zoom e le pagine prodotto ad alta densità, lasciando luce ed etichetta esattamente come nello scatto.
Immagini piccole per nuovi layout
Porta una miniatura, una foto in formato web o un vecchio asset alla dimensione che oggi serve a un banner principale o a una slide.
Consigli avanzati
Controlla la dimensione dell'originale
Scegli un livello sopra il numero di pixel attuale: un livello più basso rimpicciolisce l'immagine. Fai l'upscaling per ultimo, dopo tutte le modifiche, così i passaggi successivi non devono gestire il file più grande.
Invia
image_urle resolutionimage_urlè l'immagine e resolution sceglie 2k, 4k (predefinito) o 8k. Aggiungioutput_formatsolo se vuoi png o webp invece di jpeg.Interroga, poi scarica
La chiamata è asincrona: crea il task, interrogalo finché non termina e scarica il file dallo storage della piattaforma. Un jpeg in 8k pesa circa 8 MB, quindi calcola il tempo del download.
Introduzione
Image Upscaler ingrandisce un'immagine finita al livello 2k, 4k o 8k e intanto la rende più nitida. L'immagine in sé non cambia: composizione, colori e soggetto restano esattamente come li hai inviati. Non c'è prompt e non c'è niente da regolare oltre alla dimensione e al formato di file.
Richiesta
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
L'unico campo obbligatorio è image_url. resolution è 4k per impostazione predefinita e output_format è jpeg.
Come si comportano i livelli
Il livello è un budget di pixel, non una tela fissa, e le proporzioni restano sempre. Una foto 1024×1536 è tornata a 1672×2508 con 2k, a 3344×5017 con 4k e a 6689×10033 con 8k, ogni volta in circa 45 secondi. Un originale già più grande del livello viene rimpicciolito: un'immagine 3344×5017 inviata con 2k è tornata a 1672×2509.
Flusso del task
La chiamata è asincrona. Crea il task, interrogalo finché non raggiunge uno stato finale, poi scarica l'immagine dallo storage della piattaforma. Torna un'immagine per richiesta.
Consigli
- Scegli un livello sopra il numero di pixel dell'originale.
- Fai l'upscaling per ultimo, dopo tutte le modifiche, così i passaggi successivi non devono elaborare il file più grande.
- Parti dall'originale più pulito che hai: anche artefatti di compressione e sfocatura vengono ingranditi.
- Usa
jpegse non ti serve un'uscita senza perdita. Il nostro jpeg in 8k pesava circa 8 MB; unpngpesa diverse volte di più.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "4k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
