Le persone del prodotto

Carico la galleria…

I tuoi avatar

Carico i tuoi avatar…

Crea il tuo avatar

Venti secondi di webcam e microfono, dal browser: il sistema clona il tuo volto e la tua voce e salva l'avatar in questo conto. Lo ritrovi qui al prossimo accesso.

I tuoi dati

Esci

Cancella il token dell'accesso da questa scheda del browser. Non tocca niente sul server: il conto e gli avatar restano.

Cancella i miei dati

Elimina tutti gli avatar salvati in questo conto e il materiale che li compone — le riprese, il volto, il campione di voce. Non si torna indietro. Al termine ti dico quanti file il servizio ha dichiarato di aver rimosso: è la verifica che la cancellazione è avvenuta davvero, non un «fatto» sulla parola.

Chiavi API — per chi programma

Qui non serve entrare per parlare con le tue persone: quello si fa dalla scheda Le tue persone, senza nessuna chiave. Le chiavi servono a un programma tuo che chiama il servizio da fuori.

Ci sono due livelli. La chiave di ambiente apre tutto ciò che hai comprato. La chiave della singola persona vale solo per lei: elenca lei, apre sessioni con lei, e su un'altra persona risponde 403. Ha una quota e un registro d'uso propri e si revoca senza toccare le altre — è quella da dare a un fornitore, a un sito, a un reparto.

La chiave in uso su questo browser

Guardo se questo browser ha già una chiave di questo conto…

Il sito ne usa una sola, e se la ricorda per il tuo conto: esci, rientra, riapri il sito domani — resta quella, e le sessioni aperte con lei continuano a essere tue. Una chiave nuova nasce solo se la chiedi qui, o se il servizio ha spento quella di prima (revocata, sospesa, scaduta).

Genera una chiave

Le chiavi delle tue persone

Carico le tue persone…

Le tue chiavi

Carico le tue chiavi…

Sospendere spegne una chiave lasciandola tua: risponde 403 «chiave sospesa» e si riaccende quando vuoi. Ruotare ne conia una nuova e lascia la vecchia valida per una finestra (di solito 24 ore), il tempo di sostituirla nelle configurazioni. Revocare è definitivo: 401, e non si torna indietro.

Gli esempi pronti

Carico gli esempi…

Da un'applicazione tua

La chiave viaggia sempre in intestazione (X-API-Key), mai nell'indirizzo: un indirizzo finisce nei log del server, nella cronologia del browser e nel Referer; un'intestazione no.

Le altre intestazioni X-* viaggiano nella risposta e raccontano quanto ha impiegato ogni anello della catena (X-Tempo-Ascolto-Ms, X-Tempo-Cervello-Ms, X-Tempo-Voce-Ms, X-Tempo-Volto-Ms, X-Tempo-Totale-Ms) e quanta quota ti resta (X-Quota-Giorno, X-Quota-Usate, X-Quota-Residue). Arrivano prima del corpo: i sottotitoli si possono mostrare mentre il video si sta ancora scaricando.

CORS, detto per come funziona davvero. Da un programma (curl, Python) la chiave basta e il CORS non c'entra niente. Da una pagina web di un'altra origine, invece, il browser chiede prima il permesso al servizio: perché fetch() funzioni, il servizio deve dichiarare la tua origine e esporre le intestazioni X-*, altrimenti il browser te le nasconde anche quando arrivano. Se il browser dice che la chiamata è stata bloccata dalla politica delle origini, non è la chiave che sbaglia: è l'origine da cui chiami, e va dichiarata al servizio. L'esempio JavaScript qui sopra è quello da provare per primo.

La documentazione completa dell'API, con gli esempi curl veri, sta su /inizia.