Method: tunedModels.generateContent

Génère une réponse du modèle en fonction d'une GenerateContentRequest d'entrée.

Requête HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=tunedModels/*}:generateContent

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
model

string

Obligatoire. Nom de Model à utiliser pour générer la saisie semi-automatique.

Format : name=models/{model}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  }
}
Champs
contents[]

object (Content)

Obligatoire. Contenu de la conversation en cours avec le modèle.

Pour les requêtes à un seul tour, il s'agit d'une instance unique. Pour les requêtes multitours, il s'agit d'un champ répété contenant l'historique de la conversation et la dernière requête.

tools[]

object (Tool)

Facultatif. Liste des Tools que le modèle peut utiliser pour générer la réponse suivante.

Un Tool est un extrait de code qui permet au système d'interagir avec des systèmes externes pour effectuer une action ou un ensemble d'actions, en dehors du champ d'application du modèle. Le seul outil compatible est actuellement Function.

toolConfig

object (ToolConfig)

Facultatif. Configuration d'outil pour tout Tool spécifié dans la requête.

safetySettings[]

object (SafetySetting)

Facultatif. Liste d'instances SafetySetting uniques permettant de bloquer les contenus à risque.

Cette règle sera appliquée sur GenerateContentRequest.contents et GenerateContentResponse.candidates. Il ne doit y avoir qu'un seul paramètre par type de SafetyCategory. L'API bloque les contenus et les réponses qui ne respectent pas les seuils définis par ces paramètres. Cette liste remplace les paramètres par défaut pour chaque SafetyCategory spécifié dans safetySettings. Si aucun élément SafetySetting n'est indiqué dans la liste pour un SafetyCategory donné, l'API utilise le paramètre de sécurité par défaut de cette catégorie. Les catégories de danger HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT et HARM_CATEGORY_HARASSMENT sont acceptées.

systemInstruction

object (Content)

Facultatif. Instruction système définie par le développeur. Actuellement, il ne s'agit que d'annonces textuelles.

generationConfig

object (GenerationConfig)

Facultatif. Options de configuration pour la génération de modèles et les sorties

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de GenerateContentResponse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

Pour en savoir plus, consultez la page Présentation de l'authentification.