> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# ✨ Requêtes à Gemini via Voltask

Pour utiliser Gemini, l'IA de Google, avec Voltask, il faut passer par l'API de Google AI et par le [bloc httpRequest](https://documentation.celestory.io/fr/article/httprequest-requette-http-1i1x3i4/?bust=1744630391182).

*Une API (Application Programming Interface, Interface de Programmation Applicative) est un ensemble de fonctionnalités mises à disposition d'un client / utilisateur via une bibliothèque (méthodes d'un langage de programmation) ou un service web.*
# Clef API

Pour mettre en place l'API de Google, il faut tout d'abord se procurer une clef API qui permettra d'identifier qui utilise quoi (dans ce cas, Gemini). Voici le lien dirigeant vers la page de gestion des clefs API : https://aistudio.google.com/app/apikey

Après avoir créé une clef, il suffit de placer dans le bloc **httpRequest** de Voltask la ligne suivante dans la partie *URL* : https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key={{APIkey}}
*Il est important de changer le "{{APIkey}}" par la clef API récupérée plus tôt, ou de passer par d'autres blocs pour arriver au même résultat (dans le cas présent, la ligne est déjà prête à être utilisé dans le bloc **format**).*
# Modèle

Dans la ligne présentée précédemment, il est également possible de préciser le modèle de Gemini utilisé. Il est désigné de cette manière : *"models/gemini-2.0-flash"*. 
Les autres modèles sont trouvables sur ce [lien](https://ai.google.dev/gemini-api/docs/models?hl=fr). Dans la page se trouve des menu déroulant présentant plusieurs informations comme les types de données accepté, les limites de jeton, et le plus important ici : le code du modèle. C'est le texte associé qu'il faut mettre dans l'URL de la requête HTTP.
# Requête

Pour former la requête à Gemini, il faut le renseigner dans la section *body* du bloc **httpRequest**. La requête doit prendre la forme d'un objet JSON, et il sera de la forme suivante : {"contents": [{"parts": [{"text": "{{request}}"}]}]}
*Encore une fois, il est important de changer le "{{request}}" par la requête réelle. L'objet JSON est actuellement adapté pour être mis dans un bloc **format**).*

*Le JSON (JavaScript Object Notation) est un format de donnée textuel utilisé pour la transmission de données. Un objet JSON est la chaîne de charactères (le texte) qui contient les données à transmettre. Ces objets sont contenus entre accolades, et associent une clef à une valeur (texte, liste, nombre, une valeur booléenne, ou un autre objet JSON), séparé par deux points (par exemple : {"fruits": ["pomme", banane"], "nombre": 2, "aime": True} )*

Le header du bloc, quant à lui, devra contenir ceci : *{"Content-Type":"application/json"}*.
# Annexe

Exemple de projet Celestory : https://creator.celestory.io/project/CK_Oq97H6