API Twimi v1
API Twimi v1
API des partenaires (éditeurs, agences, intégrateurs) et des clients directs qui intègrent un avatar Twimi dans leur propre interface ou application.
Tags
Service
État du service, vérification d'une clé et consommation du mois.
Avatars
Fiche de l'avatar et fichiers du visage. L'affichage n'est jamais décompté. Le SDK Twimi fait tout cela pour vous ; ces routes servent à une intégration sans SDK.
Conversations
Ouvrir une conversation à la première action du visiteur, renouveler son jeton, la terminer. Une conversation dure 10 minutes au plus depuis son ouverture.
Questions et réponses
Poser la question du visiteur à l'IA de Twimi ; la réponse arrive en flux (SSE).
Voix
Faire parler l'avatar (texte → MP3) et transcrire la question orale du visiteur. Formules Avatar Widget et Avatar Agent.
Security Schemes
clePublique
Clé publique du déploiement, visible dans la page web. Acceptée seulement depuis les pages déclarées : le nom d'hôte de l'en-tête
Origin doit être exactement l'un des noms du déploiement, ou correspondre à un joker déclaré (*.concession.fr).http
cleSecrete
Clé secrète, jamais dans un navigateur : sur votre serveur, une application ou une borne.
http
jetonConversation
Jeton de conversation reçu de
POST /v1/conversations, valable 30 minutes (à renouveler avec /token). Sert aux questions, à la voix et à la transcription.http