Architecture des passerelles IA6 novembre 2026Flatkey Team

Comment créer une intelligence artificielle : du prototype avec API au modèle sur mesure

Guide en portugais pour créer une application d’IA : choisissez la tâche, testez une API, évaluez les données et les coûts, puis décidez si vous devez entraîner votre propre modèle.

Comment créer une intelligence artificielle : du prototype avec API au modèle sur mesure

Comment créer une intelligence artificielle dépend de ce que vous souhaitez construire. Un chatbot destiné aux clients, un classificateur de documents et un modèle de langage entraîné à partir de zéro sont des projets différents. Pour la plupart des équipes produit, la première étape viable consiste à créer une application qui utilise un modèle existant par API, teste une tâche réelle et contrôle les données, le coût et la qualité. Entraîner un modèle à partir de poids initiaux n’a de sens que lorsque vous disposez des données, de l’expérience et de la capacité de calcul nécessaires pour justifier ce choix.

Réponse rapide : définissez une tâche mesurable, réunissez 30 à 100 exemples représentatifs, créez un prototype avec un modèle existant, évaluez les erreurs, puis décidez seulement si vous avez besoin de récupération de documents, d’ajustement fin ou d’un entraînement sur mesure. « Créer une IA » n’exige pas que la première version entraîne un nouveau modèle.

Choisissez le type de projet avant de choisir la technologie

Objectif Première approche raisonnable Qui maintient le modèle ? Risque principal
Répondre à des questions ou générer du texte dans un produit Intégrer une API de modèle Fournisseur de l’API Réponses incorrectes, coût et envoi de données
Répondre à partir des documents de l’entreprise API de modèle avec recherche/récupération Fournisseur du modèle ; votre équipe maintient l’index Documents obsolètes ou accès non autorisé
Adapter un modèle à une tâche spécifique Ajustement fin d’un modèle autorisé Votre équipe ou le service choisi Données de mauvaise qualité et gain inférieur aux attentes
Créer un modèle de langage depuis le début Entraînement de poids propres Votre équipe Données, GPU, évaluation et exploitation à l’échelle

Une interface de chat peut être « votre IA » même lorsque le modèle de base provient d’un fournisseur. La valeur du produit réside dans la tâche qu’il résout, l’expérience, les règles d’accès, l’intégration aux données et l’évaluation continue. L’introduction pratique de Google au machine learning constitue un bon point de départ pour comprendre l’entraînement, la validation et les métriques avant d’investir dans l’infrastructure.

Étape 1 : décrivez une tâche restreinte et vérifiable

Évitez de commencer par « une IA qui fait tout ». Choisissez plutôt quelque chose comme « classer les e-mails de support en cinq catégories », « résumer les tickets avec les prochaines étapes » ou « répondre aux questions sur une base d’aide ». Pour chaque tâche, définissez l’entrée, la sortie, l’utilisateur, les contraintes et la condition de réussite.

Créez un ensemble initial d’exemples réels, sans données personnelles inutiles. Notez le résultat attendu ainsi que les cas difficiles : langue mixte, demande incomplète, contenu absent de la base, instructions malveillantes et documents contradictoires. Séparez les exemples de développement et de test. Si vous ajustez le prompt à l’aide de tous les exemples, vous ne disposerez ensuite plus d’un échantillon indépendant pour savoir si le système s’est amélioré.

Choisissez des métriques adaptées à la tâche. La classification peut utiliser la précision par catégorie et le taux de révision humaine. Une réponse de support peut nécessiter l’exactitude factuelle, la citation de la source, le temps de réponse et le coût par cas résolu. Le nombre de tokens à lui seul ne mesure pas l’utilité.

Étape 2 : créez un prototype avec une API de modèle

Une API réduit le travail initial lié à l’hébergement des GPU et au déploiement du modèle. Elle n’élimine pas les décisions produit : votre équipe doit toujours protéger la clé, formater l’entrée, valider la sortie et gérer les défaillances. L’interface compatible de Flatkey documente https://router.flatkey.ai/v1 pour les appels de chat completions avec le SDK OpenAI. Utilisez une clé émise par Flatkey et un alias de modèle actuel du catalogue ; ne confondez pas cette clé avec un identifiant émis directement par OpenAI.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://router.flatkey.ai/v1",
    api_key=os.environ["FLATKEY_API_KEY"],
)

answer = client.chat.completions.create(
    model=os.environ["FLATKEY_MODEL"],
    messages=[
        {"role": "system", "content": "Classifique a mensagem em: compra, suporte, cobrança ou outro. Responda apenas com uma categoria."},
        {"role": "user", "content": "Não consigo encontrar a fatura do mês passado."},
    ],
)
print(answer.choices[0].message.content)

Ce code est un test d’intégration, pas une application prête à l’emploi. Validez la catégorie renvoyée par rapport à la liste autorisée, enregistrez uniquement les données nécessaires, définissez un délai d’expiration et testez les erreurs 400, 401, 429 et 5xx. Conservez la clé sur le serveur ou dans un gestionnaire de secrets ; ne la distribuez jamais dans du JavaScript public ou dans une application mobile.

Si vous choisissez d’appeler un fournisseur directement, consultez la référence actuelle de son endpoint. Les endpoints dits « compatibles » peuvent couvrir des surfaces différentes : vérifiez le modèle, le format des outils, le streaming, les limites et la facturation. Pour un premier test, un petit appel est plus utile que de migrer tout le trafic d’un seul coup.

Étape 3 : améliorez le résultat avant l’entraînement

Lorsque le prototype échoue, classez-en la raison. La demande était-elle ambiguë ? Des données manquaient-elles ? Le modèle a-t-il reçu trop de contexte ? La réponse ne respectait-elle pas le format ? Ces causes nécessitent des solutions différentes.

  • Prompt et format : demandez une sortie courte et validable, fournissez un exemple d’entrée et de sortie, puis vérifiez le schéma du résultat.
  • Données externes : pour les politiques, documents et catalogues qui changent, récupérez l’information actuelle dans votre système et n’envoyez que les extraits pertinents. Évaluez également le contrôle d’accès ; une bonne recherche avec de mauvaises permissions peut exposer des données.
  • Flux de l’application : décomposez les tâches complexes en étapes vérifiables. Utilisez des règles métier en dehors du modèle lorsqu’elles doivent être déterministes.
  • Modèle : comparez plusieurs modèles sur la même batterie de tests. Un modèle plus grand n’est pas automatiquement meilleur pour une classification courte.

Envisagez l’ajustement fin uniquement après avoir testé ces options et réuni suffisamment d’exemples étiquetés. La documentation de Hugging Face sur le fine-tuning explique qu’il poursuit l’entraînement d’un modèle préentraîné sur les données d’une tâche ou d’un domaine ; cela diffère de la création de tous les poids à partir de zéro. Vérifiez la licence du modèle, l’origine des données, le coût d’entraînement et la procédure d’évaluation.

Étape 4 : décidez si vous avez réellement besoin d’un modèle sur mesure

Entraîner un modèle à partir de zéro exige la collecte et le nettoyage des données, la tokenisation, l’architecture, des GPU, du stockage, des expérimentations, des checkpoints, la sécurité et une équipe capable d’évaluer les régressions. Même après l’entraînement, vous devez servir le modèle avec une latence et une disponibilité acceptables. Pour de nombreux produits, ce coût ne se justifie pas avant qu’un besoin avéré auquel les API ou les modèles ouverts ne répondent pas n’existe.

Si l’exigence porte sur le contrôle des poids ou l’exécution sur votre infrastructure, comparez un modèle ouvert déjà entraîné avec votre prototype d’API. Mesurez la qualité, le throughput, la mémoire GPU, le coût par tâche et l’effort opérationnel. La section GPU Compute de Flatkey peut servir de point de départ pour examiner l’infrastructure, mais la disponibilité, le prix et la configuration doivent être vérifiés au moment de la décision. Ne calculez pas les économies en supposant une GPU toujours occupée lorsque votre charge réelle connaît des pics et des heures creuses.

Une architecture hybride est également possible : des tâches prévisibles sur un modèle ouvert sous votre contrôle et les cas difficiles sur une API de modèle externe. Cela exige un routage et une observabilité clairs, pas seulement deux endpoints configurés.

Étape 5 : préparez l’application pour une utilisation réelle

Avant de rendre le produit accessible aux utilisateurs, effectuez une vérification simple :

  1. Données et accès : quelles données entrent dans le prompt ? Qui peut consulter chaque document ? Que va-t-on mettre dans les journaux ?
  2. Qualité : évaluez séparément les cas courants, rares et adversariaux ; documentez un taux d’erreur acceptable et les cas où il faut escalader vers une personne.
  3. Coût : estimez les tokens d’entrée et de sortie, les appels par tâche, les tentatives répétées et le prix actuel du modèle. Suivez le coût par résultat utile.
  4. Exploitation : définissez un délai d’expiration, des limites, un backoff pour 429, une solution de repli et une manière de désactiver la fonction sans affecter le reste du produit.
  5. Modifications : testez à nouveau lorsque vous changez de modèle, de prompt, de documents, de SDK ou de fournisseur. Versionnez la configuration qui a généré chaque résultat.

Une réponse HTTP 200 ne prouve pas que le produit a correctement réalisé la tâche. Pour un classificateur, comparez avec l’étiquette attendue. Pour une réponse basée sur des documents, vérifiez que la citation étaye réellement l’ affirmation. Pour le contenu généré, demandez une révision humaine aux points ayant le plus d’impact.

Combien coûte la création d’une intelligence artificielle ?

Il n’existe pas de prix unique. Un prototype via API peut démarrer avec peu de trafic, mais le coût augmente avec les appels, les tokens, les modèles plus coûteux, les outils et les nouvelles tentatives. Un système avec récupération ajoute la recherche, le stockage et la maintenance des documents. Le réglage fin et l’auto-hébergement ajoutent des GPU et de l’exploitation. L’entraînement à partir de zéro accroît encore davantage ces exigences.

Créez une feuille de calcul avec cinq variables : utilisateurs actifs, tâches par utilisateur, appels par tâche, tokens par appel et taux de répétition. Multipliez par le prix actuel du modèle choisi et ajoutez le stockage, la recherche, les GPU et le travail opérationnel lorsqu’ils existent. Comparez les alternatives avec le même ensemble de tests et la même définition d’une tâche terminée. La page des tarifs de Flatkey est la source des tarifs de votre route ; si vous utilisez un autre fournisseur, consultez sa page.

Questions fréquentes

Dois-je savoir programmer pour créer une IA ?

Pour prototyper une idée, les outils visuels peuvent aider. Pour intégrer une IA dans un produit contenant des données utilisateur, quelqu’un doit s’occuper de l’authentification, des secrets, de la validation, des coûts et des erreurs. Savoir programmer ou travailler avec une équipe technique rend ces contrôles vérifiables.

Quelle est la différence entre créer une IA et entraîner une IA ?

Créer une application d’IA consiste à construire un flux utile autour d’un modèle. Entraîner consiste à modifier les paramètres d’un modèle avec des données et de la puissance de calcul. Un produit peut être nouveau et précieux sans entraîner un modèle à partir de zéro.

Puis-je créer une IA en utilisant uniquement une API ?

Oui, pour de nombreuses tâches. L’API fournit la capacité du modèle, mais votre application reste responsable de l’interface, des données, des règles, de l’évaluation et de la sécurité. Si vous avez besoin de documents à jour, ajoutez une étape de récupération au lieu de supposer que le modèle connaît vos informations internes.

Prochaine étape : choisissez une tâche, préparez des exemples de test et effectuez un petit appel. N’élargissez la portée que lorsque vous pouvez mesurer la qualité et le coût. Si la même application doit tester plusieurs modèles via une seule intégration, évaluez la route de chat completions de Flatkey avec les modèles et les limites actuelles de votre compte.