[Torna al blog](/it/blog/)  **In breve**: la [9Pic API](/it/products/api/) è per i team che vogliono ricerca, riconoscimento e clipping dentro il proprio prodotto invece di usare un front end completo in hosting. Puoi collegare il tuo storage, chiamare API REST per la ricerca tramite selfie, la ricerca per pettorale e il clipping video, e usare comunque 9Pic AI come livello di elaborazione dietro le quinte. Perché le piattaforme per eventi hanno bisogno di un'API per le foto --------------------------------------------------------------------- Sempre più aziende di media per eventi vogliono qualcosa di più di una galleria in hosting. Alcune hanno già un'app per le iscrizioni. Altre hanno un sito dell'evento personalizzato. Altre gestiscono un marketplace, un portale per i team o un'esperienza mobile con il proprio brand per i clienti. In tutti questi casi l'ostacolo è lo stesso: gli utenti si aspettano di trovare subito i contenuti, ma costruire in casa un'intelligenza fotografica affidabile è costoso e lento. Una buona API per le foto degli eventi colma questo divario. Invece di costruire la tua pipeline di riconoscimento facciale, il rilevatore di pettorali, l'estrattore di timestamp e l'orchestrazione dello storage, integri funzionalità AI collaudate direttamente nel prodotto che hai già. Questo significa: - **Mantieni il tuo front end**: design, flusso di onboarding e percorso utente restano intatti. - **Vai più veloce**: il tuo team integra API invece di inventare uno stack di machine learning. - **Resti flessibile**: lo stesso backend può servire web app, app mobile e workflow interni. - **Riduci il peso operativo**: il tuo team si concentra sul prodotto e sull'esperienza dei clienti invece che sulla gestione dei modelli. Cosa ti offre davvero la 9Pic API --------------------------------- La 9Pic API non è un generico endpoint di upload con un semplice wrapper. È l'accesso via API ai motori AI principali che alimentano lo stack di ricerca e clipping di 9Pic AI. Il prodotto è pensato per integrazioni personalizzate: il valore non sta nel “sostituire la tua app”. Sta nel “rendere più intelligente la tua app”. In sintesi, ottieni tre funzionalità principali: - **API di ricerca per numero di pettorale**, basata su [9Pic BibTrack](/it/products/bibtrack/), per trovare le foto tramite numero di gara in grandi gallerie di eventi. - **API di ricerca tramite selfie**, basata su [9Pic FaceFind](/it/products/facefind/), per permettere agli utenti di caricare un selfie e trovare subito le proprie foto. - **API di timestamp e clipping video**, basata su [9Pic Motion](/it/products/motion/), per individuare i momenti esatti in cui una persona compare in lunghi flussi video e generare clip per ogni partecipante. È questa combinazione a rendere il prodotto convincente. Non è un'API isolata. È uno stack che copre le attività di maggior valore nella gestione dei contenuti degli eventi: ricerca, recupero e consegna dei video. Quando un approccio API-first è meglio di una piattaforma tutto in uno ----------------------------------------------------------------------- Una piattaforma in hosting è la risposta giusta quando vuoi un'esperienza pronta all'uso. Un approccio API-first è migliore quando la tua azienda ha già canali di distribuzione, regole di workflow o punti di contatto con i clienti che non vuoi sostituire. La 9Pic API è particolarmente utile se stai costruendo uno di questi prodotti: - **Un'app mobile con il tuo brand** in cui chi partecipa cerca e acquista contenuti dentro la tua interfaccia. - **Un sito dell'evento personalizzato** in cui la ricerca delle foto sta accanto a iscrizioni, programma, cronometraggio o classifiche. - **Una dashboard operativa interna** per agenzie o team media che hanno bisogno di automazione senza mostrare direttamente il front end di 9Pic AI. - **Una piattaforma multi-cliente** in cui ti serve un unico livello di backend per molti brand di eventi, location o organizzatori. - **Un prodotto di workflow** che riunisce caricamenti, moderazione, consegna e comunicazione con i partecipanti sotto lo stesso tetto. In breve, se il tuo team dice “L'esperienza per i clienti ce l'abbiamo già, ci serve solo l'AI”, questo è il prodotto giusto. Le funzionalità principali dell'API nel dettaglio -------------------------------------------------- ### API di ricerca per numero di pettorale per gare ed eventi di endurance Per maratone, eventi di ciclismo, triathlon e altri sport con numero di gara, la ricerca per pettorale resta uno dei metodi più pratici. Il problema è che nella realtà i pettorali sono imperfetti: risultano sfocati, si piegano, restano in parte nascosti e compaiono da angolazioni difficili. Il motore [9Pic BibTrack](/it/products/bibtrack/) alla base della 9Pic API è progettato per queste condizioni. Puoi quindi integrare la ricerca per pettorale direttamente nel tuo prodotto senza dover costruire in autonomia la pipeline di rilevamento. Per le piattaforme che servono gare su larga scala, spesso è la strada più rapida verso una ricerca affidabile. - Utile per gli eventi di endurance in cui i partecipanti conoscono già il proprio numero. - Riduce il lavoro di tagging manuale nelle gallerie di gara con grandi volumi. - Si inserisce in modo naturale nelle app che mostrano già classifiche, tempi intermedi o profili dei partecipanti. ### API di ricerca tramite selfie per una ricerca semplice per i partecipanti La ricerca per pettorale è potente, ma non tutti gli eventi usano numeri. È qui che la ricerca tramite selfie funziona meglio come esperienza principale. Invece di chiedere agli utenti di ricordare un codice o di frugare tra le cartelle, permetti loro di caricare un selfie e ricevere le foto corrispondenti nella tua interfaccia. È la funzionalità che rende moderni i contenuti degli eventi. [9Pic FaceFind](/it/products/facefind/) dimostra già il valore di questa UX sulla piattaforma 9Pic. Con la 9Pic API, la stessa ricerca può vivere dentro la tua app, il tuo microsito o il workflow dei tuoi clienti. - Ideale per matrimoni, conferenze, eventi scolastici ed eventi privati premium. - Riduce gli ostacoli per gli utenti che non hanno un numero di pettorale o un codice evento. - Crea un'esperienza “trovami subito” più forte senza mostrare il front end di un altro fornitore. ### API di clipping video per prodotti media premium Oggi molti team di eventi registrano video lunghi, ma faticano ancora a trasformarli in contenuti per ogni singolo partecipante. Cercare a mano nel girato è costoso. Montare a mano le clip è ancora peggio. La 9Pic API risolve la parte difficile: individua dove compare una persona nel video e restituisce i tempi necessari per creare le clip. Il dettaglio importante è che la ricerca può partire da un numero di pettorale o da un selfie. Per questo il livello [9Pic Motion](/it/products/motion/) è particolarmente utile per lo sport, gli eventi equestri, i poligoni di tiro e altri formati in cui brevi clip dei partecipanti valgono abbastanza da generare coinvolgimento o ricavi. - Ti permette di aggiungere la consegna di clip premium alla tua piattaforma. - Copre i casi d'uso in cui la rapidità di consegna conta più della rifinitura manuale. - Fa evolvere un prodotto fotografico in un'esperienza multimediale più ricca senza uno stack video separato. Usare il tuo storage è un grande vantaggio ------------------------------------------- Uno dei punti di forza della 9Pic API è che non devi spostare tutta la tua attività su un nuovo modello di storage. Se la tua azienda conserva già i file in un object storage, la 9Pic API può collegarsi a esso ed elaborarli dove si trovano. La pagina del prodotto è chiara su questo punto: la 9Pic API gestisce gli storage compatibili con S3 e può lavorare con provider come Amazon S3, Google Cloud Storage, Azure Blob, Cloudflare R2, Alibaba OSS, DigitalOcean Spaces, Backblaze B2, MinIO, Wasabi e altri. Questo conta per tre motivi: - **La migrazione resta più leggera**: non riprogetti l'intera pipeline dei file solo per provare una funzionalità. - **Conformità e controllo restano più semplici**: l'architettura di storage che hai già può restare la fonte di riferimento. - **I team multipiattaforma guadagnano flessibilità**: puoi aggiungere la 9Pic API alla configurazione cloud che usi già. Per chi acquista con un profilo tecnico, è un vero elemento distintivo. “Usa il tuo storage” non è solo una comodità. È una riduzione del rischio di integrazione. Un workflow di integrazione pratico ----------------------------------- Ogni configurazione della 9Pic API è progettata su misura con il team di 9Pic, ma il workflow è semplice. Nella maggior parte dei casi, funziona così: Passo 1 Definisci la UX Decidi se gli utenti cercheranno tramite selfie, numero di pettorale o entrambi, nella tua app o nel tuo sito. Passo 2 Collega lo storage Collega 9Pic AI al tuo object storage, così foto e video vengono elaborati dove si trovano già. Passo 3 Elabora i contenuti Usa la dashboard di 9Pic e il livello di elaborazione backend per preparare eventi, gallerie o file video. Passo 4 Chiama le API Il tuo prodotto chiama gli endpoint REST per la ricerca per pettorale, la ricerca tramite selfie o il clipping dal tuo front end o dal tuo livello di servizi. Passo 5 Lancia la tua esperienza Gli utenti restano nel tuo flusso con il tuo brand, mentre 9Pic AI gestisce dietro le quinte il lavoro difficile di riconoscimento e ricerca. Ecco perché il prodotto interessa sia alle startup sia ai team affermati. L'integrazione è tecnica, ma il discorso di business è semplice: l'esperienza dei tuoi clienti resta tua. Dove la 9Pic API funziona meglio -------------------------------- L'API può servire un'ampia gamma di workflow per eventi, ma alcuni casi d'uso sono particolarmente adatti: - **Piattaforme per gare**: aggiungi la ricerca per pettorale ai prodotti di cronometraggio, iscrizione o classifiche dei partecipanti. - **Aziende di media sportivi premium**: aggiungi ricerca tramite selfie e clipping video ai pacchetti evento di valore più alto. - **Piattaforme per eventi aziendali e conferenze**: offri ai partecipanti un modo con il tuo brand per trovare le foto dell'evento, senza mostrare un fornitore di gallerie separato. - **Prodotti white label per eventi**: alimenta le esperienze di più clienti da un unico livello API. - **App e strumenti interni creati con l'AI**: usa i builder moderni per creare il front end, poi collega la 9Pic API come backend di riconoscimento pronto per la produzione. Quest'ultimo punto conta più di prima. Man mano che i team usano strumenti come Cursor, v0 o Bolt per rilasciare più in fretta software personalizzato, l'intelligenza fotografica nel backend diventa il collo di bottiglia. La 9Pic API è pensata per eliminarlo. Se è un agente di programmazione a scrivere l'integrazione, installa prima 9Pic Skills, le skill ufficiali: `npx skills add https://docs.9pic.ai`. Così Cursor, Claude Code e Codex imparano a tenere la chiave API nel tuo backend, a riutilizzare gli id delle richieste di ricerca e a mostrare anteprime con filigrana. La [guida all'installazione di 9Pic Skills](/it/blog/9pic-agent-skills/) e la [documentazione sulle Agent Skills](https://docs.9pic.ai/agent-skills/) sono il punto di partenza; questo articolo resta il racconto del prodotto per le persone. Cosa sapere prima di valutarla ------------------------------ La 9Pic API non è un prodotto self-service. È un'integrazione personalizzata guidata insieme al team di 9Pic. È importante perché fissa le aspettative giuste: - Affrontala come un progetto di integrazione, non come una registrazione alla dashboard. - Di solito definirai con il team l'architettura e il workflow esatti. - Funziona al meglio quando l'API fa parte di una vera strategia di prodotto, non di un esperimento isolato. Per gli operatori seri, spesso è un vantaggio. Significa che la soluzione si può adattare al tuo stack reale, al tuo modello di storage e alla tua esperienza utente, invece di costringerti in un workflow generico. Domande frequenti ----------------- ### La 9Pic API è self-service? No. La 9Pic API è proposta come integrazione personalizzata. Lavori con il team di 9Pic per definire architettura, workflow e rilascio per il tuo caso d'uso. ### Quali API sono disponibili oggi? Le funzionalità principali sono la ricerca per numero di pettorale, la ricerca tramite selfie o volto, e l'estrazione di timestamp e il clipping dai video. Corrispondono agli stessi motori AI usati da BibTrack, FaceFind e Motion. ### Posso usare il mio storage cloud? Sì. La 9Pic API gestisce gli storage compatibili con S3 ed è pensata per lavorare con i principali provider come Amazon S3, Google Cloud Storage, Azure Blob, Cloudflare R2, Alibaba OSS, DigitalOcean Spaces, Backblaze B2, MinIO, Wasabi e servizi simili. ### Posso usarla da un'app mobile o da un sito personalizzato? Sì. Se la tua piattaforma può fare richieste HTTP, può integrarsi con la 9Pic API. Questo vale per web app, app mobile, servizi backend, siti di eventi e strumenti interni. ### L'accesso API include tutti i prodotti 9Pic? No. L'API espone i motori AI principali per ricerca e clipping. Prodotti come [9Pic Flow](/it/products/flow/), [9Pic Checkout](/it/products/checkout/), [9Pic Buzz](/it/products/buzz/) e [9Pic Certify](/it/products/certify/) fanno parte dell'esperienza più ampia della piattaforma in hosting, non del livello API. Prossimi passi -------------- Se il tuo team ha già un prodotto e vuole alimentarlo con un'intelligenza fotografica pronta per la produzione, parti dalla domanda sull'architettura: dove si trovano oggi le tue foto e i tuoi video, e quale esperienza utente vuoi mantenere? Da lì, la 9Pic API si può definire attorno alle funzionalità di ricerca e clipping che contano di più. Per valutare se fa per te, [contatta il team di 9Pic AI](/it/contact/) o consulta la [pagina prodotto della 9Pic API](/it/products/api/). Se stai impostando il progetto con un agente di programmazione, [installa 9Pic Skills con npx skills add](/it/blog/9pic-agent-skills/) prima che scriva le chiamate HTTP. Iniziamo? --------- Unisciti agli organizzatori di eventi che usano 9Pic AI per l'hosting, la ricerca con l'AI e la consegna dei contenuti: 100M+ foto già consegnate a 5M+ partecipanti in 5k+ eventi. [Inizia](https://admin.9pic.ai/sign-up) [Prenota una demo](/it/contact/)