API per ingrandire immagini senza registrazione

L'iscrizione tipica a un'API e quello che serve davvero su Airpic

Il percorso abituale per usare un'API di immagini con IA è quasi sempre lo stesso. Crei un account con e-mail e password, confermi l'indirizzo, entri in un pannello per sviluppatori, generi una chiave, inserisci una carta di credito, scegli un piano con un tetto mensile di chiamate e, spesso, accetti che le immagini inviate possano restare sui server del fornitore per un periodo che non controlli. Prima di aver elaborato una sola foto hai lasciato dati personali, un metodo di pagamento e una decina di minuti.

Su Airpic quel percorso non esiste perché non esiste un account. La web funziona con crediti al portatore: compri un pacchetto, ricevi un codice che inizia con 0TK e lo conservi dove preferisci. L'API usa la stessa identica cosa. Non c'è una chiave da sviluppatore separata dal codice crediti: il codice è la chiave. Lo passi nell'intestazione Authorization come token Bearer quando scarichi il file completo, e basta.

In pratica, per iniziare servono tre cose:

1. Un pacchetto di crediti. Il pacchetto «Stampa 100 + API» è quello pensato per chi programma, perché include cento download in grande formato e l'accesso all'API, ma qualsiasi pacchetto funziona dall'API, anche il più piccolo.
2. Il codice 0TK che ricevi dopo l'acquisto, salvato sul tuo server e mai dentro un'app o una pagina web: chiunque lo legga può spendere i tuoi crediti, esattamente come farebbe con una chiave API tradizionale.
3. Un client HTTP qualunque. Non c'è un SDK da installare: sono tre chiamate HTTP con un form multipart, che puoi fare con curl, con la libreria standard del tuo linguaggio o da uno script di automazione.

C'è una conseguenza che vale la pena sottolineare: non puoi restare bloccato per un dato mancante. Nessuna verifica dell'identità, nessun piano da scegliere, nessun periodo di prova che scade dopo due settimane. Se il codice ha crediti, la chiamata funziona. Se finiscono, compri un altro pacchetto e cambi una stringa nella configurazione. Per capire il ragionamento dietro questa scelta, dalla privacy al prezzo per immagine, c'è la pagina perché Airpic non chiede un account.

Cosa puoi chiamare: dall'upscale all'API per rimuovere lo sfondo senza registrazione

L'API espone gli stessi strumenti della web, con gli stessi parametri. Non esiste una versione ridotta per sviluppatori: quello che scegli con un cursore o un menu nella pagina dello strumento, lo passi come campo JSON nelle opzioni del lavoro. Questo significa che puoi provare a mano una foto, trovare le impostazioni giuste e poi riprodurle in automatico su cento file simili.

Per le immagini puoi chiamare:

• Ingrandire: fattore ×2 e ×4 per l'uso standard; ×8, ×16 e Max per il grande formato fino a 600 megapixel, elaborati a mosaico; stile «nitidezza estrema» per foto e testo o «resa pittorica» per illustrazioni; opzione per migliorare i volti.
• Ingrandire anime e illustrazioni: modello separato per il disegno piatto, ×2 o ×4.
• Rimuovere lo sfondo: sfondo trasparente, bianco, nero o un colore in esadecimale, con i bordi calcolati a risoluzione piena, capelli compresi, senza aloni. Se cercavi un'API per la rimozione dello sfondo senza registrazione, è lo stesso lavoro che fai nella pagina per rimuovere lo sfondo da una foto, con il parametro dello sfondo al posto del menu.
• Comprimere: uscita JPEG, WebP, AVIF o PNG, qualità, peso obiettivo in KB, lato massimo e rimozione dei metadati conservando il profilo ICC. Gira su CPU e risponde in secondi.
• Colorare, rimuovere il rumore e correggere la sfocatura: ognuno con il suo cursore di intensità e, dove serve, la variante (naturale o vivido per il colore; mosso o fuori fuoco per la sfocatura).
• Restaurare foto antiche: ricostruzione dei volti, ingrandimento del fondo, ricolorazione facoltativa, cursore di fedeltà e fino a tre foto di riferimento della stessa persona per guidare la somiglianza, inviate come campi aggiuntivi del form. Limite di 20 megapixel in ingresso.
• Rimuovere oggetti: l'immagine più una maschera PNG della stessa dimensione come secondo campo del form. Nella web la maschera la dipingi nell'editor; dall'API la generi tu, per esempio da un rilevatore di oggetti.

Per i video ci sono trascrivere (99 lingue, ZIP con TXT, SRT, VTT e JSON), video in documento (DOCX, PDF o Markdown con riassunto e capitoli) e creare short (clip 9:16 con sottotitoli parola per parola). I file grandi non passano in una sola richiesta: c'è un caricamento a pezzi. Chiedi un identificativo di upload, invii le parti una per una, chiudi l'upload e crei il lavoro con quell'identificativo al posto del file.

L'ingresso accettato per le immagini è JPG, PNG (anche con trasparenza e a 16 bit), WebP, TIFF, HEIC e AVIF; l'orientamento EXIF viene applicato e il profilo ICC conservato, quindi un file che arriva da un iPhone o da uno scanner calibrato esce con i colori giusti senza conversioni da parte tua. I nomi esatti dei campi, i valori ammessi e gli esempi con curl stanno nella pagina /developers/ di airpic.app, che è l'unico riferimento aggiornato: se cambia qualcosa, cambia lì, e questo articolo non pretende di sostituirla.

Come si paga: un'API di immagini con IA a consumo, un credito per download

Il modello è lo stesso della web e si riassume in una frase: elaborare è gratis, paghi il download del file completo. Ogni lavoro produce un'anteprima ridotta che puoi scaricare senza spendere nulla, utile per controllare il risultato o per mostrarlo al tuo utente prima di decidere. Il primo download del file completo consuma un credito del tipo giusto dal codice che passi come Bearer; i download successivi dello stesso lavoro sono gratuiti.

I crediti sono di tre tipi, e dall'API valgono come dalla web:

• Standard: immagini fino a 32 megapixel, cioè ×2, ×4, rimozione dello sfondo, rumore, colore, sfocatura, restauro e rimozione di oggetti. Con il pacchetto da 100 immagini ogni download costa 0,099 €.
• Grande formato: ×8, ×16 e Max, fino a 600 megapixel, per la stampa. Con il pacchetto «Stampa 100 + API» il grande formato parte da 0,49 € a immagine e include l'accesso all'API.
• Video: ogni trascrizione, documento o serie di short conta come un video. I prezzi aggiornati di tutti i pacchetti sono nella pagina dello strumento, non qui: cambiano, e un articolo invecchia.

Tre regole che semplificano la contabilità di un'integrazione:

1. I crediti non scadono. Puoi comprare un pacchetto oggi e consumarlo in sei mesi; non c'è un rinnovo mensile che azzera il saldo né una quota minima da spendere.
2. Comprimere è gratis del tutto, anche dall'API: elaborazione e download senza consumare crediti. Se il tuo caso d'uso è solo comprimere immagini prima di pubblicarle, non ti serve neppure un codice.
3. Se un lavoro fallisce non paghi: lo stato di errore non addebita nulla e il credito di un lavoro non riuscito viene restituito.

Il saldo si consulta con una chiamata senza autenticazione che restituisce quanti crediti standard, grande formato e video restano sul codice: comodo per avvisare l'utente, o te stesso, prima di esaurirli. Vale anche dall'API il download gratuito al mese per indirizzo IP, quindi la prima prova completa la fai senza comprare nulla. Se vuoi vedere come funziona l'anteprima prima del pagamento nella web, c'è l'articolo su come vedere il risultato prima di pagare.

Limiti onesti: quota per IP, tetto di GPU e partenza a freddo

Un'API senza registrazione non può distinguere un cliente dall'altro con un account, quindi i limiti sono per indirizzo IP e per codice. Vale la pena conoscerli prima di progettare l'integrazione, perché cambiano il modo in cui conviene inviare i lavori.

• Quota oraria per IP. La pagina /developers/ pubblica il limite: 20 lavori l'ora per indirizzo IP. Oltre, la creazione del lavoro viene rifiutata finché la finestra non scorre. Per un'automazione che elabora un catalogo intero significa mettere in coda e distribuire nel tempo, non lanciare tutto insieme. Se ti serve di più, scrivi indicando il tuo codice e il limite viene alzato.
• Lavori in parallelo. I worker GPU sono condivisi tra tutti gli utenti. La regola di buon uso è tenere al massimo due lavori in volo per volta: il terzo non viene bloccato, ma rallenta tutti, te compreso.
• Tetto giornaliero di GPU. Esiste un limite complessivo di secondi di GPU al giorno per tutto il servizio. Se viene raggiunto, la creazione di nuovi lavori risponde con un errore esplicito e non viene addebitato nulla; i lavori già accettati si completano. È una protezione contro i picchi, non una quota tua, ma un'integrazione seria deve gestire quella risposta e riprovare più tardi.
• Partenza a freddo. I modelli non restano caricati in memoria quando nessuno li usa. La prima chiamata dopo un periodo di inattività paga l'avvio del worker e il caricamento dei pesi: decine di secondi, fino a un minuto e mezzo, prima che il lavoro passi da «in coda» a «in elaborazione». Le chiamate successive, a motore caldo, durano quanto il lavoro in sé. Nei nostri test del 3 settembre 2026, con foto da 0,3 a 1 megapixel, il ×4 ha richiesto tra 6 e 9 secondi; con «Migliora i volti» attivo, circa 17 secondi.
• Scadenza dei risultati. Il file elaborato viene cancellato un'ora dopo il download e, se non lo scarichi, dopo un giorno al massimo. Non è un archivio: il tuo codice deve scaricare e conservare il risultato dalla sua parte. Lo stesso vale per l'originale, eliminato a fine lavoro, e nessuna immagine viene usata per addestrare modelli. Le GPU stanno nell'Unione Europea, come spiegato in dove finiscono le tue foto quando usi un'IA.

Un'avvertenza che vale più delle altre: questa API non è adatta a un uso in tempo reale. Se il tuo prodotto ha bisogno di una risposta entro due secondi mentre l'utente aspetta, la partenza a freddo da sola lo rende impossibile, e nessuna impostazione la elimina. Funziona bene per code di lavoro, elaborazioni notturne, flussi di pubblicazione e tutto ciò che può aspettare qualche decina di secondi.

Un secondo avviso riguarda l'ingrandimento in sé, e vale sia dall'API sia dalla web: il modello aggiunge dettaglio coerente, non recupera informazione che nella foto non c'è. Una foto da 320 × 240 pixel portata a ×4 è ottima per uno schermo, ma non diventa una stampa in A3 solo perché ha più pixel. E se i volti nell'originale sono più piccoli di un centinaio di pixel, l'opzione «Migliora i volti» tende a inventare un viso generico: conviene lasciarla spenta, oppure passare allo strumento per restaurare foto antiche, dove regoli la fedeltà e puoi allegare foto di riferimento della stessa persona.

Upscale image via API: l'esempio minimo in tre passi, poi la prova a mano

Senza inventare nulla che non trovi nella documentazione, il flusso completo per fare upscale di un'immagine via API si descrive in tre passi:

1. Crei il lavoro. Una richiesta POST con un form multipart: il file dell'immagine, il nome dello strumento (ingrandire) e le opzioni come JSON, per esempio il fattore ×4 e lo stile nitido. La risposta è l'identificativo del lavoro. Non serve autenticazione per questo passo, perché elaborare è gratis.
2. Interroghi lo stato. Una GET sull'identificativo, ogni uno o due secondi. Vedi passare «in coda», poi «in elaborazione», poi «completato» con larghezza, altezza, peso e formato del risultato, l'indirizzo dell'anteprima gratuita e quello del download. Se arriva «errore», il messaggio spiega il motivo e non ti viene addebitato nulla.
3. Scarichi il file completo. Una GET sull'indirizzo del download con l'intestazione Authorization: Bearer seguita dal tuo codice 0TK. Il primo download consuma un credito; se il codice non ne ha di quel tipo ricevi un errore 402 con il tipo di credito mancante, e puoi ripiegare sull'anteprima o fermarti.

Se il lavoro da automatizzare è un altro, la logica non cambia: lo stesso codice serve per trascrivere un video in testo dopo un caricamento a pezzi, o per restaurare un archivio di ritratti con le foto di riferimento allegate al form. E se il grande formato per la stampa è il tuo caso principale, la guida su come ingrandire un'immagine per la stampa spiega quale fattore scegliere per ogni misura.

Prima di scrivere il codice, conviene fare lo stesso lavoro a mano una volta, con la foto che userai davvero: è il modo più rapido per capire quale fattore e quale stile ti servono, e i valori che scegli sono gli stessi che poi passerai nelle opzioni. Il percorso nella web:

1. Apri la pagina per ingrandire un'immagine e trascina la foto nella scheda. Vedi subito la miniatura, il nome, le dimensioni di ingresso e quelle di uscita previste.
2. In «Uso» scegli Uso standard per ×2 e ×4, oppure Per stampe di grande formato se devi arrivare a ×8, ×16 o Max: lì indichi le dimensioni di stampa in centimetri e la distanza di osservazione, e la pagina ti dice quale fattore basta per i ppi necessari.
3. Apri Impostazioni avanzate. In «Stile», Nitidezza estrema è la scelta per foto e testo, Resa pittorica per illustrazioni e texture morbide. Spunta Migliora i volti (IA) solo se i volti sono grandi e nitidi abbastanza. In «Formato di uscita» lascia auto, a meno che tu non abbia bisogno proprio di JPG o WebP.
4. Premi Elabora immagine. Durante l'elaborazione vedi la barra di avanzamento e, la prima volta, l'attesa della partenza a freddo. Nei nostri test del 19 settembre 2026 una foto da 320 × 240 pixel è stata ingrandita ×4 a 1280 × 960 pixel in 5 secondi, a motore caldo.
5. Controlla il risultato con il confronto prima/dopo e con la vista al 100 %, che mostra i pixel reali. Se non ti convince, cambia stile o fattore e premi di nuovo: l'elaborazione resta gratuita.
6. Premi Scarica il file completo. Usa il tuo download gratuito del mese oppure un credito del codice. Da questo momento sai esattamente quali opzioni mettere nel JSON della tua chiamata.

Quando il risultato a mano ti convince, hai già tutto quello che serve per l'API: lo stesso codice, le stesse opzioni, lo stesso file. Comincia da qui e ingrandisci un'immagine senza account.

FAQ

Continua a leggere