AgilePersona

Avatar conversazionale sovrano: inizia in 5 minuti

1. Ottieni una API key

Accedi al portale sviluppatori come amministratore e crea una nuova chiave. La chiave viene mostrata una sola volta: copiala subito.

La password amministratore di default è impostata dalla variabile ADMIN_PASSWORD (default admin).

2. Crea una sessione avatar

Ogni conversazione richiede una sessione. Puoi indicare lingua e voce.

# Sostituisci $API_KEY con la tua chiave
curl -X POST http://localhost:8000/v1/sessioni \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"persona":"demo","lingua":"it","voce":"it"}'

L'API risponde con l'id della sessione, ad esempio:

{"id":"sess_01J7K..."}

3. Fai parlare l'avatar

Invia una foto del volto e il testo da pronunciare. Riceverai un video mp4.

curl -X POST "http://localhost:8000/v1/sessioni/$ID_SESSIONE/parla" \
  -H "X-API-Key: $API_KEY" \
  -F "testo=Ciao, sono la tua persona digitale." \
  -F "riferimento=@volto.png" \
  --output parla.mp4

4. Verifica lo stato

curl -H "X-API-Key: $API_KEY" http://localhost:8000/v1/sessioni/$ID_SESSIONE

5. Cancella la sessione

I riferimenti del volto rimangono solo sui nostri server finché la sessione esiste. Puoi eliminarli in qualsiasi momento.

curl -X DELETE -H "X-API-Key: $API_KEY" http://localhost:8000/v1/sessioni/$ID_SESSIONE

Endpoint di base