# Gemini - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/ai_gemini

Language: fr

Chat et contenu multimédia via Google Gemini

## Utilisation et spécificités

Sélectionnez un identifiant du fournisseur, un modèle accessible et les prompts. Images, documents et JSON structuré dépendent des capacités du modèle. La sortie expose text, model, usage, json et attachmentsProcessed. Le modèle proposé par défaut n’est pas une garantie de disponibilité.

Type technique : `ai_gemini`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : gemini](/docs/credentials/gemini)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `credentialId` | `string` | - | - |
| `model` | `string` | `"gemini-3.8-flash"` | - |
| `systemPrompt` | `string` | `""` | - |
| `userPrompt` | `string` | `""` | - |
| `temperature` | `number` | - | -; ≥ 0, ≤ 2 |
| `maxTokens` | `number` | - | -; ≥ 1 |
| `timeoutSeconds` | `number` | - | -; ≥ 1, ≤ 3600 |
| `attachments` | `array` | `[]` | - |
| `attachments[].kind` | `enum` | `"text"` | `text`, `image_url`, `image_base64`, `document_url`, `document_base64` |
| `attachments[].sourceMode` | `enum` | `"manual"` | `manual`, `node`, `file` |
| `attachments[].source` | `string` | `""` | - |
| `attachments[].mimeType` | `string` | - | - |
| `attachments[].name` | `string` | - | - |
| `messages` | `array` | `[]` | - |
| `messages[].role` | `enum` | `"user"` | `user`, `assistant`, `system` |
| `messages[].content` | `string` | `""` | - |
| `responseFormat` | `enum` | `"text"` | `text`, `json` |
| `jsonSchema` | `string` | `""` | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `credentialId`<br>Identifiant IA | Clé API enregistrée sur la page Identifiants pour ce fournisseur. |
| `model`<br>Modèle | Identifiant du modèle chez le fournisseur (ex. gpt-4o, claude-3-5-sonnet). |
| `systemPrompt`<br>Prompt système | Instructions système envoyées au modèle avant le prompt utilisateur. |
| `userPrompt`<br>Prompt utilisateur | Message principal - expressions {{…}} autorisées. |
| `temperature`<br>Température | Créativité demandée au modèle (0 à 2). Laissez vide pour sa valeur par défaut. Ce paramètre est omis pour les modèles de raisonnement OpenAI et Azure qui ne le prennent pas en charge. |
| `maxTokens`<br>Tokens max. | Nombre maximal de tokens de sortie, raisonnement compris pour les modèles concernés. Une réponse tronquée provoque une erreur : augmentez cette limite ou réduisez la demande. |
| `timeoutSeconds`<br>Délai maximal (secondes) | Durée maximale d’un appel au modèle, pièces jointes comprises. De 1 à 3 600 secondes ; 120 par défaut. L’annulation du workflow interrompt aussi l’appel. |
| `responseFormat`<br>Format de réponse | Texte libre ou JSON structuré (avec schéma optionnel). |
| `jsonSchema`<br>Schéma JSON (optionnel) | Schéma JSON optionnel pour contraindre et vérifier la sortie json. Utilisez un modèle compatible avec les sorties structurées. Pour OpenAI en mode strict : objet racine, champs requis et additionalProperties à false. Une réponse non conforme provoque une erreur. |

## Exemples

- Prompt utilisateur

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "model": "gemini-3.8-flash",
  "systemPrompt": "",
  "userPrompt": "",
  "attachments": [],
  "messages": [],
  "responseFormat": "text",
  "jsonSchema": ""
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)