Skip to content
Learni
View all tutorials
Intelligence Artificielle

Comment utiliser Replicate pour l'IA en 2026

12 minBEGINNER
Intelligence ArtificielleAPIReplicate

Introduction

Replicate est une plateforme qui permet d'exécuter des modèles de machine learning via une API simple et scalable. En 2026, elle reste incontournable pour les développeurs souhaitant intégrer rapidement des fonctionnalités d'IA sans gérer d'infrastructure. Ce tutoriel vous montre comment commencer avec Replicate en JavaScript, depuis l'installation jusqu'à l'exécution d'un premier modèle. Vous apprendrez à gérer les entrées, les sorties et les erreurs de manière professionnelle.

Prérequis

  • Node.js 20+
  • Compte Replicate gratuit (replicate.com)
  • Connaissances de base en JavaScript et npm

Installation du package

terminal
npm install replicate

Cette commande installe le client officiel Replicate pour Node.js. Il gère l'authentification et les appels API de manière optimisée.

Création du client Replicate

Après l'installation, initialisez le client avec votre token API personnel. Ce token est disponible dans les paramètres de votre compte Replicate.

Initialisation du client

replicate-client.ts
import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Le client est configuré avec le token stocké dans une variable d'environnement. Cela évite d'exposer des clés sensibles dans le code source.

Exécution d'un modèle simple

Choisissez un modèle public comme llava-13b pour une première génération. Fournissez les inputs attendus par le modèle.

Appel du modèle

generate.ts
const output = await replicate.run(
  "yorickvp/llava-13b:5b6c7f4e8f7e4f7c8b9a1d2e3f4a5b6c",
  {
    input: {
      image: "https://example.com/photo.jpg",
      prompt: "Décris cette image en français",
    },
  }
);
console.log(output);

Cet appel exécute le modèle avec une image et un prompt. Le résultat est retourné directement sous forme de tableau ou de texte selon le modèle.

Gestion des sorties

handle-output.ts
if (Array.isArray(output)) {
  output.forEach((item) => console.log(item));
} else {
  console.log(output);
}

Les modèles Replicate renvoient souvent un tableau. Cette vérification simple permet d'afficher correctement tous les résultats.

Gestion des erreurs

error-handling.ts
try {
  const output = await replicate.run(...);
} catch (error) {
  console.error("Erreur Replicate:", error);
}

Toujours encapsuler les appels dans un try/catch pour gérer les erreurs réseau ou les limites de quota.

Bonnes pratiques

  • Stockez toujours le token dans des variables d'environnement
  • Vérifiez la documentation du modèle avant utilisation
  • Ajoutez des timeouts pour les requêtes longues
  • Surveillez votre consommation de crédits Replicate
  • Utilisez des modèles optimisés pour votre cas d'usage

Erreurs courantes à éviter

  • Oublier de définir REPLICATE_API_TOKEN
  • Utiliser un identifiant de modèle obsolète
  • Ignorer les limites de taille des inputs
  • Ne pas gérer les réponses asynchrones longues

Pour aller plus loin

Explorez les modèles avancés et les déploiements personnalisés sur learni-group.com/formations.