Domande frequenti

Pexafy è un motore di ricerca immagini basato sull'intelligenza artificiale che aggrega milioni di immagini gratuite e premium da più fonti — Unsplash, Pexels, Pixabay, Wikimedia Commons e altre — in un'unica API. Invece di integrare decine di servizi di immagini, effettui una sola richiesta a Pexafy e ottieni i migliori risultati da tutte le fonti, classificati per rilevanza semantica tramite IA.

Registra un account gratuito su pexafy.com/auth/register/, poi vai su Dashboard → Chiavi API → Crea chiave. La tua prima chiave viene creata immediatamente senza richiedere una carta di credito. Il piano gratuito include 1K richieste API al mese.

Sì! Il nostro piano Gratuito ti offre 1K richieste API al mese — nessuna carta di credito richiesta. Puoi effettuare ricerche testuali e accedere a tutte le fonti di immagini gratuite. Hai bisogno di più richieste, immagini premium o ricerca immagine-per-immagine? Consulta la nostra pagina Prezzi per i piani Pro e Business.

Pexafy aggrega attualmente immagini da Unsplash, Pexels, Pixabay, Wikimedia Commons e Openverse. Stiamo aggiungendo continuamente nuove fonti. Puoi filtrare i risultati per fonte utilizzando il parametro source nell'API.

Pexafy è un'API pensata per gli sviluppatori, non un motore di ricerca per consumatori. Aggreghiamo solo fonti gratuite e Creative Commons, quindi ogni risultato è sicuro da utilizzare nel tuo prodotto. Il nostro modello IA comprende il significato semantico — cerca 'atmosfera accogliente d'autunno' e ottieni immagini pertinenti, non semplici corrispondenze di parole chiave. Inoltre, ricevi risposte JSON strutturate, paginazione, filtri e analisi sull'utilizzo — tutto tramite un'unica API REST.

Attualmente forniamo un'API REST con documentazione completa. SDK ufficiali per Python, JavaScript/TypeScript e PHP sono nella nostra roadmap. Nel frattempo, l'API è semplice da integrare — basta una singola richiesta HTTPS con un'intestazione contenente la chiave API. Consulta la nostra documentazione per esempi di codice in diversi linguaggi.

I limiti di frequenza dipendono dal tuo piano: Gratuito — 20 richieste/minuto, Pro — 60 richieste/minuto, Business — 300 richieste/minuto. Se superi il limite, riceverai una risposta 429 Too Many Requests con un'intestazione Retry-After che indica quando puoi riprovare.

Tutte le risposte sono in JSON con un envelope standard: {success, data, meta, pagination, error}. Ogni oggetto foto include: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors e relevance score.

Pexafy utilizza la paginazione basata su cursore. Ogni risposta include un valore pagination.next_cursor. Passalo come parametro cursor nella richiesta successiva per ottenere la pagina seguente. Quando next_cursor è null, hai raggiunto la fine.

Sì! Puoi filtrare per: color_name (red, blue, green…), color_hex (es. #FF5733 con color_tolerance opzionale), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) e score_threshold (rilevanza minima 0.0–1.0). Combina i filtri per risultati precisi.

Aggiungi la tua chiave API come intestazione della richiesta: X-Api-Key: pxfy_your_key_here. In alternativa, utilizza l'autenticazione con token Bearer: Authorization: Bearer <jwt_token>. Non condividere mai la tua chiave API nel codice lato client.

Puoi richiedere fino a 80 risultati per pagina tramite il parametro per_page (il valore predefinito è 20). Per set di risultati di grandi dimensioni, utilizza la paginazione basata su cursore per recuperare le pagine successive. Non esiste alcun limite al numero totale di pagine attraverso cui puoi navigare.

Sì! Il nostro modello è stato addestrato su dati multilingua, quindi puoi effettuare ricerche in inglese, francese, spagnolo, tedesco, portoghese e molte altre lingue. La comprensione semantica funziona al meglio in inglese, ma la maggior parte delle query comuni in altre lingue produce risultati accurati. Consigliamo l'inglese per la massima precisione.

Sì, puoi eseguire un upgrade o un downgrade in qualsiasi momento da Dashboard → Fatturazione. Gli upgrade hanno effetto immediato con fatturazione proporzionale. I downgrade hanno effetto alla fine del periodo di fatturazione corrente. Tutto viene gestito automaticamente tramite Stripe.

Le richieste API vengono bloccate una volta raggiunto il limite mensile — riceverai una risposta 429 con un messaggio di errore dettagliato. Per continuare a utilizzare l'API, esegui l'upgrade a un piano superiore da Dashboard → Fatturazione.

Offriamo una garanzia soddisfatti o rimborsati di 14 giorni su tutti i piani a pagamento. Se non sei soddisfatto entro i primi 14 giorni dall'iscrizione, contattaci all'indirizzo [email protected] e ti rimborseremo completamente, senza fare domande.

Accettiamo tutte le principali carte di credito e di debito (Visa, Mastercard, American Express), nonché Apple Pay e Google Pay — tutti elaborati in modo sicuro tramite Stripe. Non memorizziamo alcuna informazione di pagamento sui nostri server.

Nessun contratto, nessun impegno. Tutti i piani sono mensili (o annuali con sconto, se preferisci). Disdici in qualsiasi momento da Dashboard → Fatturazione con un solo clic. Il tuo accesso continua fino alla fine del periodo di fatturazione corrente.

Sì! Pagando annualmente risparmi circa il 17%: Pro è $290/anno ($24/mese) invece di $29/mese. Business è $2990/anno ($249/mese) invece di $299/mese. Passa alla fatturazione annuale da Dashboard → Fatturazione.

Sì! Se le tue esigenze superano il piano Business — limiti di frequenza più elevati, infrastruttura dedicata, SLA personalizzato o distribuzione on-premise — contattaci all'indirizzo [email protected] specificando le tue necessità. Prepareremo un piano su misura per la tua organizzazione.

Tutti i prezzi sono indicati in USD. Stripe, il nostro gestore dei pagamenti, converte automaticamente nella tua valuta locale al momento del pagamento. La tua banca potrebbe applicare una piccola commissione di cambio valuta a seconda del tipo di carta e del paese.

No. Pexafy è un motore di ricerca — indicizziamo e ricerchiamo immagini ospitate su piattaforme di terze parti (Unsplash, Pexels, Pixabay, ecc.). Non archiviamo, ospitiamo né redistribuiamo i file immagine effettivi. Tutte le immagini rimangono di proprietà dei rispettivi fotografi e piattaforme.

Dipende dalla licenza della fonte. Unsplash, Pexels e Pixabay offrono licenze di uso commerciale gratuito per la maggior parte delle loro immagini. Wikimedia Commons e Openverse utilizzano varie licenze Creative Commons — alcune consentono l'uso commerciale, altre no. Verifica sempre il campo della licenza nella risposta API e controlla all'URL sorgente prima di utilizzare un'immagine a fini commerciali.

Le immagini premium appaiono nei risultati di ricerca, ma potrebbero richiedere un abbonamento o un acquisto sulla piattaforma di origine per scaricarle in alta risoluzione. L'API restituisce anteprime/miniature per tutte le immagini. Con i piani Free e Pro, l'URL sorgente nella risposta indica dove accedere all'immagine completa.

Pexafy restituisce URL alle immagini ospitate sulle loro piattaforme originali — non distribuiamo file immagine direttamente tramite l'API. Per le immagini gratuite (Unsplash, Pexels, Pixabay), puoi scaricare l'immagine in piena risoluzione dall'URL sorgente fornito nella risposta. Rispetta sempre i termini di servizio della piattaforma di origine.

La nostra pipeline di indicizzazione viene eseguita ogni giorno per tutte le principali fonti. Le nuove immagini caricate su Unsplash, Pexels, Pixabay e altre piattaforme sono in genere ricercabili tramite Pexafy entro 24–48 ore. Il nostro indice contiene attualmente oltre 5 milioni di immagini e cresce ogni giorno.

Vai su Dashboard → Impostazioni → Zona pericolosa → Elimina account. L'eliminazione dell'account è permanente e rimuove tutte le tue chiavi API, la cronologia di utilizzo e i dati personali. Puoi anche inviarci un'email a [email protected] per richiedere la cancellazione ai sensi del GDPR/diritto all'oblio.

Sì. Utilizziamo HTTPS ovunque, bcrypt per l'hashing delle password e archiviamo le sessioni in Redis con token JWT a breve scadenza. Non vendiamo né condividiamo i tuoi dati con terze parti. Le chiavi API vengono sottoposte a hashing prima dell'archiviazione. Leggi la nostra Informativa sulla privacy per tutti i dettagli sulle pratiche relative ai dati.

Sì, a seconda del tuo piano: Free (1 chiave), Pro (5 chiavi), Business (∞ chiavi). Più chiavi ti permettono di separare l'utilizzo per applicazione, ambiente (dev/staging/prod) o membro del team, e di revocare singole chiavi senza influire sulle altre.

Revoca immediatamente la chiave compromessa da Dashboard → Chiavi API e creane una nuova. La revoca ha effetto immediato: qualsiasi richiesta che utilizza la vecchia chiave verrà rifiutata con un errore 401. Non inserire mai le chiavi API nel controllo versione; utilizza invece le variabili d'ambiente.

Puntiamo a un uptime del 99,9% per la disponibilità delle API. I clienti del piano Business ricevono un SLA con impegni di uptime. Puoi monitorare lo stato del servizio in tempo reale e storico sulla nostra pagina Stato, accessibile dal footer di questo sito.

Sì. Raccogliamo solo i dati minimi necessari per erogare il servizio (email, password con hash, log di utilizzo). Non vendiamo dati a terze parti. Puoi richiedere un'esportazione completa dei dati o la loro cancellazione in qualsiasi momento da Dashboard → Impostazioni o inviando un'email a [email protected]. Consulta la nostra Informativa sulla privacy per tutti i dettagli.