¶ Fare affari con le AI API, spesso la parte più complicata non è l'interfaccia stessa
Quando molti team pianificano per la prima volta di creare una piattaforma AI API, tendono istintivamente a pensare: “Prima integriamo i modelli, poi completeremo gradualmente il resto.”
Solo dopo aver iniziato davvero scoprono che l'interfaccia è soltanto una parte del tutto.
Devi anche sviluppare il sito ufficiale, organizzare il catalogo dei servizi, scrivere la documentazione per gli sviluppatori, definire i prezzi, gestire registrazione e accesso, fornire ai clienti API Key e risolvere inoltre questioni come brand, dominio, assistenza clienti e termini sulla privacy.
Per i team di sviluppo, queste cose non sono necessariamente difficili, ma sono molto frammentate. Ogni modulo deve essere realizzato e deve inoltre collegarsi agli altri. Quando il sito, il sistema di account e il centro documentazione saranno finalmente utilizzabili, potrebbe essere già passato molto tempo.
Anche per i clienti aziendali l'esperienza è molto diretta. Di solito non collaborano immediatamente solo perché hai “integrato molti modelli”, ma verificano prima alcuni aspetti: riescono a trovare rapidamente il servizio di cui hanno bisogno? I prezzi sono chiari? Esiste documentazione per sviluppatori leggibile direttamente? Dopo la registrazione possono ottenere la propria API Key? Se incontrano problemi, riescono a trovare il fornitore del servizio?
Questo è anche il problema centrale che White Label API Platform deve risolvere: i servizi AI sottostanti sono forniti dalla piattaforma, mentre tu concentri le tue energie su brand, presentazione del prodotto, prezzi, documentazione e gestione dei clienti, invece di sviluppare nuovamente un intero portale.
¶ Quale problema risolve esattamente White Label API Platform?
In parole semplici, fornisce agli sviluppatori e ai clienti aziendali un portale per sviluppatori direttamente accessibile.
Dopo essere entrati nel sito, i clienti possono visualizzare i servizi AI che offri, conoscere i prezzi, leggere la documentazione e poi decidere come integrarli nelle proprie applicazioni, siti web o flussi di lavoro. Per il momento non è necessario scrivere codice API nella fase di creazione del portale: la priorità è prima creare il sito che i clienti possono vedere e utilizzare.
Questo tipo di piattaforma è particolarmente adatto ai team che possiedono già sviluppatori o clienti aziendali, gestiscono comunità tecnologiche o prodotti SaaS, desiderano offrire varie AI API, ma non vogliono prima investire molto tempo nello sviluppo del sito ufficiale e del sistema di account.
Va chiarito che White Label non significa acquistare una soluzione software completamente indipendente, né trasformare la piattaforma sottostante in un database utenti separato. Puoi impostare il nome del sito, le icone, il catalogo dei servizi, i prezzi del canale e le informazioni di assistenza clienti, ma devi comunque presentare personalmente il prodotto, rispondere alle domande dei clienti, mantenere i contenuti e gestire le relazioni con i clienti.
¶ Prepara prima il nome del brand e il prefisso del sottodominio
Prima della creazione ufficiale, non è necessario preparare un complesso piano di branding. Basta prima definire il nome del brand che vedranno i clienti e il prefisso del sottodominio utilizzato per generare l'indirizzo di accesso al sistema.
Ad esempio, puoi prima preparare una breve descrizione dell'attività:
Fornisce API di conversazione, immagini e video agli sviluppatori di applicazioni.
Quando crei il sito, utilizza l'account amministratore per accedere ad Ace Data Cloud Platform. Non utilizzare l'account che intendi fornire ai clienti per i test per creare il sito, così da evitare che i permessi di gestione e le identità dei clienti si confondano in seguito.
¶ Crea un sito in Site Management
Dopo essere entrato nella console Platform, trova Site Management e fai clic su Create nell'angolo in alto a destra.
Se nella pagina sono già presenti siti, puoi accedere alla gestione dalla scheda corrispondente. Dopo aver completato la creazione, verifica prima il nome del sito e il dominio sulla scheda, quindi fai clic su Manage per continuare la configurazione, facendo attenzione a non premere per errore il pulsante di eliminazione.
Se sulla scheda compaiono contemporaneamente il dominio di sistema e il dominio ufficiale, non significa che siano stati creati due siti: sono semplicemente diversi punti di accesso allo stesso sito.
¶ Quando inserisci il prefisso, non ripetere il dominio completo
Il modulo di creazione richiederà di compilare il prefisso del sito e il nome del sito.
Il prefisso deve essere composto da 3 a 32 lettere minuscole, numeri o trattini, non può iniziare né terminare con un trattino e non può contenere trattini consecutivi. .platform.acedata.cloud sulla destra viene già completato automaticamente dal sistema e non deve essere inserito nuovamente.
Nel campo del nome inserisci il nome del brand che intendi utilizzare pubblicamente, quindi fai clic su Confirm dopo aver verificato che sia corretto.
Qui si consiglia di non rendere il prefisso troppo lungo. In futuro i clienti potrebbero utilizzare questo indirizzo durante test, dimostrazioni o comunicazioni: un prefisso breve e facilmente riconoscibile sarà più comodo.
¶ Fai in modo che il sito sembri prima il tuo brand
Dopo aver creato il sito, accedi a Manage → Site Settings.
Compila prima le informazioni di branding più essenziali:
| Voce di configurazione | Contenuto consigliato |
|---|---|
| Site Name | Il nome del brand utilizzato pubblicamente |
| Description | Una frase che chiarisca i principali clienti e servizi |
| Logo | L'immagine del brand visualizzata nelle pagine del sito |
| Favicon | L'icona quadrata utilizzata nella scheda del browser |
| Studio Address | L'indirizzo radice HTTPS dello Studio dello stesso brand; se non disponibile, può essere lasciato temporaneamente vuoto |
Description può essere scritta così: “Fornisce API di conversazione, immagini e video agli sviluppatori di applicazioni.”
L'indirizzo Origin assegnato dal sistema è di sola lettura. Se in futuro desideri passare al tuo dominio ufficiale, devi andare su Custom Domain, anziché modificare qui il campo Origin.
¶ Ci sono molti accessi al backend, non è necessario configurarli tutti in una volta
Dopo essere entrato nel backend di gestione, vedrai più aree di lavoro. Al primo utilizzo, è facile non sapere da dove iniziare a causa dei molti accessi disponibili. In realtà puoi cercarli direttamente in base all'obiettivo aziendale:
| Cosa fare ora | Area di lavoro corrispondente |
|---|---|
| Modificare il brand e consentire ai clienti di accedere | Site Settings、Authentication Settings |
| Impostare homepage e navigazione | Navigation Menu、Homepage Banner |
| Decidere quali servizi visualizzare e i relativi prezzi | Services and Pricing、Documentation Management |
| Impostare l'assegnazione dei nuovi clienti | Distribution Settings |
| Passare al proprio dominio | Custom Domain |
| Visualizzare le informazioni operative e aggiungere accordi | Site Statistics、Terms and Privacy |
Alcuni accessi su dispositivi mobili potrebbero trovarsi nel pannello Settings Directory. Se la pagina è diversa dai vecchi tutorial, non è necessario cercare ripetutamente le precedenti schede superiori: individua direttamente l'area di lavoro in base al nome nell'interfaccia corrente.
¶ Dopo la creazione, non avere fretta di collegare il dominio ufficiale
Dopo aver salvato le informazioni di base, fai clic su Visit Site nell'angolo in alto a destra della pagina dei dettagli, copia l'indirizzo di accesso assegnato dal sistema e aprilo in una finestra in incognito del browser. La finestra di navigazione in incognito è più vicina allo stato che vede un nuovo cliente alla sua prima visita al sito web. Si consiglia di verificare se la home page, il catalogo dei servizi, l'accesso alla documentazione e l'accesso al login funzionano correttamente, e se il nome del brand e il Logo sono corretti.
Se il Banner non è ancora configurato, nella home page potrebbe apparire uno stato vuoto: questo non significa che la creazione del sito web non sia riuscita.
Un approccio più prudente consiste nel confermare prima che il dominio di sistema possa essere utilizzato normalmente, e poi associare il dominio ufficiale. In questo modo, se in futuro il sito web non dovesse aprirsi, sarà possibile determinare più rapidamente se il problema riguarda la configurazione del sito o la risoluzione del dominio.
¶ Un sito web che si apre è solo l'inizio
Dopo aver completato le configurazioni sopra indicate, disponi già di un portale per sviluppatori API di base.
Se desideri operare davvero rivolgendoti ai clienti, dovrai poi continuare a completare la home page e la navigazione, il catalogo dei servizi, i prezzi dei canali, la documentazione per sviluppatori, il login dei clienti, l'ottenimento e la consegna delle API Key, il dominio ufficiale, il punto di accesso al servizio clienti, nonché i termini di servizio e l'informativa sulla privacy.
All'inizio non è necessario rendere disponibili tutti i servizi AI contemporaneamente. Un approccio più pratico consiste nel selezionare prima un numero limitato di servizi con cui hai familiarità, che sai spiegare chiaramente e per i quali puoi fornire supporto. Una volta che il feedback dei clienti e i processi operativi saranno stabili, potrai poi ampliare il catalogo.
Per gli sviluppatori e i clienti aziendali, avere molti servizi non equivale necessariamente a una buona esperienza. Poterli trovare, comprenderli, avere prezzi chiari e ricevere aiuto durante l'integrazione è spesso più importante.
¶ Conclusione
Il valore della creazione di una White Label API Platform non consiste soltanto nel risparmiare il lavoro di sviluppo di una pagina web, ma nel organizzare prima brand, presentazione dei servizi, prezzi, documentazione e punti di accesso per i clienti che in origine erano separati.
In questo modo, il team non deve aspettare che tutti i sistemi siano sviluppati da zero per poter prima permettere ai clienti di vedere il prodotto, comprendere i servizi e iniziare a convalidare le esigenze reali.
Se i tuoi clienti desiderano integrare l'AI in applicazioni, siti web o workflow aziendali, puoi iniziare dalla API Platform. Se invece ti rivolgi principalmente a utenti comuni che non scrivono codice e desiderano creare contenuti direttamente, allora White Label Studio potrebbe essere più adatto.