API

Qu’est-ce qu’une API ?

Imaginez le comptoir d’un magasin. Vous n’entrez pas dans la réserve : vous demandez au comptoir, selon des règles claires, et on vous remet ce que vous avez demandé. Une API joue ce rôle entre logiciels. Elle expose une liste d’opérations, par exemple « transcris cet audio » ou « crée ce contact », et précise quelles données envoyer et ce que vous recevrez en retour.

En intelligence artificielle, presque tous les modèles s’utilisent ainsi. Votre application ne fait pas tourner le modèle : elle envoie le texte ou l’audio à une API et récupère le résultat. Chaque appel est une inférence facturée, souvent en tokens.

Comment ça marche

La plupart des API web suivent le même schéma :

1. Requête. Votre programme envoie un appel HTTP à une adresse (l’endpoint), avec une méthode (GET pour lire, POST pour créer) et une clé qui vous identifie.
2. Traitement. Le service vérifie la clé, exécute le travail et prépare la réponse.
3. Réponse. Vous recevez un code d’état (200 si tout va bien, 4xx ou 5xx sinon) et les données, presque toujours en JSON.

Une réponse typique ressemble à ceci :

{
  "id": "job_123",
  "status": "completed",
  "text": "Bonjour, je voudrais un rendez-vous jeudi."
}

Attention aux termes voisins. Avec une API, vous demandez. Avec un webhook, on vous prévient quand quelque chose se passe. Le MCP est un standard qui permet à un modèle d’IA de découvrir et d’utiliser des outils, souvent des API sous le capot. Et le function calling est la façon dont le modèle choisit quelle fonction appeler, avec quels paramètres.

Exemple

Un cabinet de kinésithérapie lyonnais conserve les notes vocales que dictent les kinés après chaque séance. Son développeur écrit un petit script : chaque nuit, il envoie les nouveaux audios à une API de transcription automatique, récupère le texte et l’ajoute au dossier du patient. Plus personne ne retape les notes, et le dossier est à jour le lendemain matin.

L’API d’IA d’UTIO

UTIO propose une API d’IA pour les développeurs et les agences : transcription, synthèse vocale, texte, image, OCR et embeddings, plus le CRM et les canaux d’UTIO, avec une seule clé. Ce sont les mêmes endpoints que ceux des produits UTIO en production.

Chaque jeton d’accès naît dans le panneau avec le client associé, un plafond de dépense et une limite de requêtes, et se révoque à l’instant. Les appels qui envoient par un canal (WhatsApp, voix ou e-mail) exigent l’en-tête Idempotency-Key, pour qu’une nouvelle tentative ne duplique pas un message. La référence complète des paramètres et des modèles se trouve dans le panneau.