Gemini Generate Content

Créez des réponses textuelles, multimodales, avec outils et exécution de code via Gemini Content et Parts.

L’API Generate Content utilise Content et Parts pour les requêtes textuelles, multimodales, d’appel de fonctions et d’exécution de code. Les résultats sont renvoyés avec Candidates, Usage Metadata et les informations de sécurité. Les requêtes sont authentifiées avec une clé API Bearer ; les modalités d’entrée, outils et paramètres avancés varient selon le modèle. Fiez-vous aux modèles visibles pour le compte actuel et aux descriptions officielles de leurs capacités.

POST/v1beta/models/{model}:generateContent

Génère des réponses textuelles, multimodales, avec appels de fonctions ou exécution de code à l’aide de Gemini Content et Parts.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Paramètres de chemin

model*string

Identifiant du modèle de génération. Le chemin est automatiquement construit sous la forme models/{model}.

Valeur par défaut"MODEL_ID"

Corps de requête

Gemini représente le texte, les entrées multimodales, les outils et la configuration de génération avec Content et Parts.

application/json

Conversation textuelle

Organisez une conversation textuelle à un ou plusieurs tours avec des Content user et model.

contents[]: Contenu de la conversation dans l’ordre.
parts[].text: Texte de chaque message.
role: Auteur du message, généralement user ou model.

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Bonjour ! Présentez-vous."
        }
      ]
    }
  ]
}

Utilisez Content et les Part text pour une conversation textuelle à un ou plusieurs tours.

contents*array<>

Content textuels dans l’ordre. Chaque message fournit son contenu via parts[].text.

Éléments1 <= items

tools?array<>

Fonctions, exécution de code, recherche, URL Context, File Search, MCP et autres outils utilisables par le modèle.

toolConfig?

Configuration des appels d’outils de la requête.

safetySettings?array<>

Seuils de blocage du contenu par catégorie de sécurité.

systemInstruction?

Instructions système définies par le développeur ; seul le texte est actuellement pris en charge.

generationConfig?

Configuration de génération et de sortie du modèle.

cachedContent?string

Nom du contenu mis en cache utilisé comme contexte, au format cachedContents/{cachedContent}.

serviceTier?ServiceTier

Niveau de service utilisé pour la requête.

Valeurs autorisées

"unspecified"
"standard"
"flex"
"priority"

store?boolean

Contrôle la journalisation de cette requête et, si défini, prévaut sur la configuration du projet.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "Bonjour ! Présentez-vous."          }        ]      }    ]  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Bonjour ! Je suis un assistant IA qui peut répondre à vos questions et vous aider dans vos tâches."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 24
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 24,
    "totalTokenCount": 32,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 24
      }
    ]
  },
  "modelVersion": "MODEL_ID",
  "responseId": "response-example"
}

Documentation officielle Google Gemini Generate ContentConsultez la définition du protocole du fournisseur et les dernières modifications des champs.

Authentification

Paramètres de chemin

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`