# API Twimi v1

import { Link } from "zudoku/components";

L'API Twimi permet aux **partenaires** (éditeurs, agences, intégrateurs) et aux **clients directs** d'intégrer un avatar Twimi dans leur propre interface : ouvrir une conversation, poser les questions du visiteur à l'IA de Twimi, faire parler l'avatar avec sa voix et transcrire les questions orales.

:::warning{title="Préversion 1.0.0-preview.12"}

Toutes les routes de la v1 sont en place, avec le décompte (5 réponses parlées = 1 conversation). Les routes peuvent encore évoluer avant la version 1.0.0 : suivez l'[historique des versions](/changelog).

:::

## Adresses

| Environnement | Adresse | Clés acceptées |
| --- | --- | --- |
| Essais | `https://api-dev.atwimi.com/v1` | `pk_test_…`, `sk_test_…` |
| Production | `https://api.twimi.ai/v1` (à venir) | `pk_live_…`, `sk_live_…` |

Une clé de test est refusée en production, et une clé de production est refusée en essais.

## Par où commencer

<div className="grid sm:grid-cols-2 gap-4 not-prose my-6">
  <Link to="/demarrage-rapide" className="block rounded-lg border p-5 hover:border-primary transition-colors">
    <div className="font-semibold mb-1">Démarrage rapide</div>
    <div className="text-sm text-muted-foreground">De la clé à la première réponse parlée, en cinq appels.</div>
  </Link>
  <Link to="/authentification" className="block rounded-lg border p-5 hover:border-primary transition-colors">
    <div className="font-semibold mb-1">Clés et jetons</div>
    <div className="text-sm text-muted-foreground">Clé publique, clé secrète, jeton de conversation : laquelle utiliser où.</div>
  </Link>
  <Link to="/voix-et-decompte" className="block rounded-lg border p-5 hover:border-primary transition-colors">
    <div className="font-semibold mb-1">Voix et décompte</div>
    <div className="text-sm text-muted-foreground">Ce qui est compté dans votre forfait, et ce qui ne l'est jamais.</div>
  </Link>
  <Link to="/api" className="block rounded-lg border p-5 hover:border-primary transition-colors">
    <div className="font-semibold mb-1">Référence de l'API</div>
    <div className="text-sm text-muted-foreground">Chaque route, ses paramètres, ses réponses et ses erreurs.</div>
  </Link>
</div>

## Avec ou sans SDK

Le **[SDK Twimi](/sdk)** (préversion) s'occupe de tout : il charge le visage, ouvre la conversation au bon moment, renouvelle le jeton et synchronise les lèvres sur la voix, la sienne ou la vôtre. **[Voir la démonstration](https://api-dev.atwimi.com/v1/sdk/demo/).** Pour poser toute la **fenêtre de conversation** dans votre site en quelques lignes : [Fenêtre de conversation](/fenetre) ([démonstration](https://api-dev.atwimi.com/v1/sdk/demo/widget.html)). Les autres pages décrivent l'API pour une intégration directe (application mobile, borne, interface sur mesure), ou pour comprendre ce que fait le SDK.

## Aide

Chaque erreur porte un `request_id` (aussi dans l'en-tête `X-Request-Id`). Donnez-le au support, **contact@twimi.ai** : il permet de retrouver la requête dans nos journaux.