Note

Bonjour et bienvenue sur la communauté Facebook des passionnés de Raspberry Pi, Arduino et ESP32 de SunFounder ! Plongez plus profondément dans Raspberry Pi, Arduino et ESP32 avec d’autres passionnés.

Pourquoi rejoindre ?

• Support d’experts : Résolvez les problèmes après-vente et les défis techniques avec l’aide de notre communauté et de notre équipe.

• Apprendre et partager : Échangez des conseils et des tutoriels pour améliorer vos compétences.

• Aperçus exclusifs : Accédez en avant-première aux annonces de nouveaux produits et aux aperçus.

• Réductions spéciales : Profitez de remises exclusives sur nos tout nouveaux produits.

• Promotions festives et concours : Participez à des concours et des promotions de vacances.

👉 Prêt à explorer et créer avec nous ? Cliquez sur here et rejoignez-nous dès aujourd’hui !

18. Connexion aux LLM en Ligne

Dans cette leçon, nous allons apprendre à connecter votre Pidog (ou Raspberry Pi) à différents grands modèles de langage (LLM) en ligne. Chaque fournisseur nécessite une clé API et propose différents modèles parmi lesquels vous pouvez choisir.

Nous verrons comment :

• Créer et sauvegarder vos clés API en toute sécurité.

• Choisir un modèle adapté à vos besoins.

• Exécuter notre code d’exemple pour discuter avec les modèles.

Procédons étape par étape pour chaque fournisseur.

---

Avant de Commencer

Assurez-vous d’avoir terminé :

• Installer tous les modules (Important) — Installez les modules robot-hat, vilib, pidog, puis exécutez le script i2samp.sh.

OpenAI

OpenAI propose des modèles puissants comme GPT-4o et GPT-4.1 qui peuvent être utilisés pour des tâches de texte et de vision.

Voici comment configurer :

Obtenir et sauvegarder votre clé API

1. Allez sur OpenAI Platform et connectez-vous. Sur la page API keys, cliquez sur Create new secret key.

   

2. Remplissez les détails (Propriétaire, Nom, Projet et autorisations si nécessaire), puis cliquez sur Create secret key.

   

3. Une fois la clé créée, copiez-la immédiatement — vous ne pourrez plus la revoir. Si vous la perdez, vous devrez en générer une nouvelle.

   

4. Dans votre dossier de projet (par exemple : /pidog/examples), créez un fichier nommé secret.py :

   cd ~/pidog/examples
   sudo nano secret.py
   

5. Collez votre clé dans le fichier comme ceci :

   # secret.py
   # Store secrets here. Never commit this file to Git.
   OPENAI_API_KEY = "sk-xxx"
   

Activer la facturation et vérifier les modèles

1. Avant d’utiliser la clé, allez sur la page Billing de votre compte OpenAI, ajoutez vos informations de paiement et approvisionnez un petit montant de crédits.

   

2. Ensuite, allez sur la page Limits pour vérifier quels modèles sont disponibles pour votre compte et copiez l’ID exact du modèle à utiliser dans votre code.

   

Tester avec le code d’exemple

1. Ouvrez le code d’exemple :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, gpt-4o) :

   from pidog.llm import OpenAI
   from secret import OPENAI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = OpenAI(
       api_key=OPENAI_API_KEY,
       model="gpt-4o",
   )
   

   Sauvegardez et quittez (Ctrl+X, puis Y, puis Enter).

3. Enfin, lancez le test :

   sudo python3 18.online_llm_test.py
   

---

Gemini

Gemini est la famille de modèles d’IA de Google. C’est rapide et excellent pour les tâches polyvalentes.

Obtenir et sauvegarder votre clé API

1. Connectez-vous à Google AI Studio, puis allez sur la page des clés API.

   

2. Cliquez sur le bouton Create API key dans le coin supérieur droit.

   

3. Vous pouvez créer une clé pour un projet existant ou un nouveau projet.

   

4. Copiez la clé API générée.

   

5. Dans votre dossier de projet :

   cd ~/pidog/examples
   sudo nano secret.py
   

6. Collez la clé :

    # secret.py
    # Store secrets here. Never commit this file to Git.
   GEMINI_API_KEY = "AIxxx"
   

Vérifier les modèles disponibles

Allez sur la page officielle Gemini Models, vous y verrez la liste des modèles, leurs identifiants API exacts et le cas d’utilisation pour lequel chacun est optimisé.

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, gemini-2.5-flash) :

   from pidog.llm import Gemini
   from secret import GEMINI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Gemini(
       api_key=GEMINI_API_KEY,
       model="gemini-2.5-flash",
   )
   

3. Sauvegardez et lancez :

   sudo python3 18.online_llm_test.py
   

---

Qwen

Qwen est une famille de grands modèles de langage et de modèles multimodaux fournis par Alibaba Cloud. Ces modèles prennent en charge la génération de texte, le raisonnement et la compréhension multimodale (comme l’analyse d’images).

Obtenir une clé API

Pour appeler les modèles Qwen, vous avez besoin d’une clé API. La plupart des utilisateurs internationaux doivent utiliser la console DashScope International (Model Studio). Les utilisateurs de Chine continentale peuvent utiliser la console Bailian (百炼).

• Pour les utilisateurs internationaux

  1. Allez sur la page officielle Get API Key de Alibaba Cloud.

  2. Connectez-vous ou créez un compte Alibaba Cloud.

  3. Accédez à Model Studio (choisissez la région Singapour ou Pékin).

     • Si une invite « Activate Now » apparaît en haut de la page, cliquez dessus pour activer Model Studio et recevoir le quota gratuit (Singapour uniquement).

     • L’activation est gratuite — vous ne serez facturé qu’après utilisation de votre quota gratuit.

     • Si aucune invite d’activation n’apparaît, le service est déjà actif.

  4. Allez sur la page Key Management. Dans l’onglet API Key, cliquez sur Create API Key.

  5. Après la création, copiez votre clé API et conservez-la en lieu sûr.

  

  Note

  Les utilisateurs de Hong Kong, Macao et Taiwan doivent également choisir l’option International (Model Studio).

• Pour les utilisateurs de Chine continentale

  Si vous êtes en Chine continentale, vous pouvez utiliser la console Alibaba Cloud Bailian (百炼) :

  1. Connectez-vous à Bailian console (console Bailian) et complétez la vérification du compte.

  2. Sélectionnez Create API Key. Si un message indique que les services de modèle ne sont pas activés, cliquez sur Activate, acceptez les conditions et réclamez votre quota gratuit. Après activation, le bouton Create API Key sera activé.

     

  3. Cliquez à nouveau sur Create API Key, vérifiez votre compte, puis cliquez sur Confirm.

     

  4. Une fois créée, copiez votre clé API.

     

Sauvegarder votre clé API

1. Dans votre dossier de projet :

   cd ~/pidog/examples
   sudo nano secret.py
   

2. Collez votre clé comme ceci :

   # secret.py
   # Store secrets here. Never commit this file to Git.
   
   QWEN_API_KEY = "sk-xxx"
   

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, qwen-plus) :

   from pidog.llm import Qwen
   from secret import QWEN_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Qwen(
       api_key=QWEN_API_KEY,
       model="qwen-plus",
   )
   

3. Lancez avec :

   sudo python3 18.online_llm_test.py
   

Grok (xAI)

Grok est l’IA conversationnelle de xAI, créée par l’équipe d’Elon Musk. Vous pouvez vous y connecter via l’API xAI.

Obtenir et sauvegarder votre clé API

1. Inscrivez-vous pour un compte ici : xAI Cloud Console. Ajoutez d’abord des crédits à votre compte — sinon l’API ne fonctionnera pas.

2. Allez sur la page API Keys, cliquez sur Create API key.

   

3. Saisissez un nom pour la clé, puis cliquez sur Create API key.

   

4. Copiez la clé générée et conservez-la en lieu sûr.

   

5. Dans votre dossier de projet :

   cd ~/pidog/examples
   sudo nano secret.py
   

6. Collez votre clé comme ceci :

   # secret.py
   # Store secrets here. Never commit this file to Git.
   
   GROK_API_KEY = "xai-xxx"
   

Vérifier les modèles disponibles

Allez sur la page Models de la console xAI. Vous y verrez tous les modèles disponibles pour votre équipe, ainsi que leurs identifiants API exacts — utilisez ces identifiants dans votre code.

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, grok-4-latest) :

   from pidog.llm import Grok
   from secret import GROK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Grok(
       api_key=GROK_API_KEY,
       model="grok-4-latest",
   )
   

3. Lancez avec :

   sudo python3 18.online_llm_test.py
   

---

DeepSeek

DeepSeek est un fournisseur chinois de LLM qui propose des modèles abordables et performants.

Obtenir et sauvegarder votre clé API

1. Connectez-vous à Deepseek Platform.

2. Dans le menu en haut à droite, sélectionnez API Keys → Create API Key.

   

3. Saisissez un nom, cliquez sur Create, puis copiez la clé.

   

4. Dans votre dossier de projet :

   cd ~/pidog/examples
   sudo nano secret.py
   

5. Ajoutez votre clé :

   # secret.py
   DEEPSEEK_API_KEY = "sk-xxx"
   

Activer la facturation

Vous devez d’abord recharger votre compte. Commencez par un petit montant (comme 10 RMB).

Modèles disponibles

Au moment de la rédaction (2025-09-12), DeepSeek propose :

• deepseek-chat

• deepseek-reasoner

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, deepseek-chat) :

   from pidog.llm import Deepseek
   from secret import DEEPSEEK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Deepseek(
       api_key=DEEPSEEK_API_KEY,
       model="deepseek-chat",
       max_messages=20,
   )
   

3. Lancez :

   sudo python3 18.online_llm_test.py
   

---

Doubao

Doubao est la plateforme de modèles d’IA de ByteDance (Volcengine Ark).

Obtenir et sauvegarder votre clé API

1. Connectez-vous à Volcengine.

2. Dans le menu de gauche, faites défiler jusqu’à API Key Management → Create API Key.

   

3. Choisissez un nom et cliquez sur Create.

   

4. Cliquez sur l’icône Show API Key et copiez-la.

   

5. Dans votre dossier de projet :

   cd ~/pidog/examples
   sudo nano secret.py
   

6. Ajoutez votre clé :

   # secret.py
   DOUBAO_API_KEY = "xxx"
   

Choisir un modèle

1. Allez sur le marketplace de modèles et choisissez un modèle.

   

2. Par exemple, choisissez Doubao-seed-1.6, puis cliquez sur API 接入.

   

3. Sélectionnez votre clé API et cliquez sur Use API.

   

4. Cliquez sur Enable Model.

   

5. Survolez l’ID du modèle pour le copier.

   

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu par le code ci-dessous, et mettez à jour model="xxx" avec le modèle souhaité (par exemple, doubao-seed-1-6-250615) :

   from pidog.llm import Doubao
   from secret import DOUBAO_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Doubao(
       api_key=DOUBAO_API_KEY,
       model="doubao-seed-1-6-250615",
   )
   

3. Lancez avec :

   sudo python3 18.online_llm_test.py
   

General

Ce projet prend en charge la connexion à plusieurs plateformes LLM via une interface unifiée. Nous avons une compatibilité intégrée avec :

• OpenAI (ChatGPT / GPT-4o, GPT-4, GPT-3.5)

• Gemini (Google AI Studio / Vertex AI)

• Grok (xAI)

• DeepSeek

• Qwen (通义千问)

• Doubao (豆包)

De plus, vous pouvez vous connecter à tout autre service LLM compatible avec le format de l’API OpenAI. Pour ces plateformes, vous devrez obtenir manuellement votre clé API et le base_url correct.

Obtenir et sauvegarder votre clé API

1. Obtenez une clé API auprès de la plateforme que vous souhaitez utiliser. (Consultez la console officielle de chaque plateforme pour plus de détails.)

2. Dans votre dossier de projet, créez un nouveau fichier :

   cd ~/pidog/examples
   nano secret.py
   

3. Ajoutez votre clé dans secret.py :

   # secret.py
   API_KEY = "your_api_key_here"
   

Avertissement

Gardez votre clé API privée. Ne téléchargez pas secret.py dans des dépôts publics.

Tester avec le code d’exemple

1. Ouvrez le fichier de test :

   cd ~/pidog/examples
   sudo nano 18.online_llm_test.py
   

2. Remplacez le contenu d’un fichier Python par l’exemple suivant, et remplissez le base_url et le model corrects pour votre plateforme :

   Note

   À propos de base_url : Nous prenons en charge le format API OpenAI, ainsi que toute API qui lui est compatible. Chaque fournisseur a son propre base_url. Veuillez consulter sa documentation.

   from pidog.llm import LLM
   from secret import API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = LLM(
       base_url="https://api.example.com/v1",  # fill in your provider's base_url
       api_key=API_KEY,
       model="your-model-name-here",           # choose a model from your provider
   )
   

3. Lancez le programme :

   python3 18.online_llm_test.py