Domande frequenti

Pexafy è un motore di ricerca immagini basato sull'intelligenza artificiale che aggrega milioni di immagini a uso libero da 9 fonti — Unsplash, Pexels, Pixabay, Kaboompics, Burst e altre ancora — in un'unica API. Una richiesta Pexafy = una ricerca semantica su tutte le 9 fonti. Con le API native dei provider, la stessa ricerca richiede da 3 a 5 chiamate, più la logica di fusione e la normalizzazione JSON: codice che scrivi, mantieni e paghi tu.

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 5K richieste API al mese.

No. La tua chiave funziona dalla prima chiamata: nessuna revisione dell'applicazione, nessun periodo di attesa e nessuna chiamata obbligatoria di tracciamento dei download da effettuare ad ogni download. Unsplash limita le applicazioni non approvate a 50 richieste/ora fino alla revisione della tua app; Pexels consente 200/ora.

Sì! Il nostro piano Free ti offre 5K richieste API al mese — senza carta di credito — e cerca in tutte le fonti indicizzate da Pexafy, come ogni altro piano. Ti servono più richieste? I piani a pagamento, da Starter a Enterprise, alzano i limiti: consulta la nostra pagina Prezzi.

Pexafy aggrega attualmente 9 fonti, le principali delle quali sono Unsplash, Pexels, Pixabay, Kaboompics, Burst. Continuiamo ad aggiungerne di nuove. Puoi filtrare i risultati per fonte usando 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ì, cambia piano in qualsiasi momento da Dashboard → Fatturazione. La modifica è immediata e Creem, il nostro rivenditore, la calcola pro rata: passare a un piano superiore addebita la differenza di prezzo per il resto del periodo in corso, passare a un piano inferiore la rimborsa.

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. Creem, il nostro rivenditore, lo riaccredita sul metodo di pagamento originale. Dettagli nella nostra Politica di rimborso: pexafy.com/legal/refund/

I pagamenti sono elaborati da Creem, il nostro rivenditore e Merchant of Record. Puoi pagare con carta di credito o di debito, oppure con gli altri metodi di pagamento che Creem offre al checkout nel tuo paese. Non vediamo né conserviamo mai i dati della tua carta.

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 fino al 18%: Pro è $199/anno ($17/mese) invece di $19/mese. Business è $2599/anno ($217/mese) invece di $249/mese. Passa alla fatturazione annuale da Dashboard → Fatturazione.

Sì! Se le tue esigenze superano il piano Enterprise — 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 e Creem, il nostro rivenditore, li addebita in USD. A seconda del paese, al checkout possono aggiungersi imposte come l'IVA. Se la tua carta è in un'altra valuta, la tua banca converte l'importo e può applicare una piccola commissione di cambio.

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 per uso commerciale gratuito per la maggior parte delle loro immagini, e le fonti minori che indicizziamo seguono lo stesso modello. Verifica sempre il campo licenza nella risposta API e controlla l'URL della fonte prima di utilizzare un'immagine a scopo commerciale.

No. Pexafy non vende immagini. Ogni risultato proviene da una libreria di immagini di libero utilizzo — Unsplash, Pexels, Pixabay, Kaboompics, Burst e altre — e rimanda a essa, con la licenza propria di quella libreria. Il tuo piano paga solo il servizio di ricerca: richieste API, limiti di frequenza, chiavi API e supporto. Verifica la licenza di ogni immagine alla fonte prima di usarla.

Pexafy restituisce URL alle immagini ospitate sulle loro piattaforme originali — non distribuiamo file immagine direttamente tramite l'API. 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 9M+ 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.