Passer au contenu principal
POST
/
v1
/
models
/
{model}
:generateContent
Generate content (Gemini)
curl --request POST \
  --url https://api.dgrid.ai/v1/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello from DGrid."
        }
      ]
    }
  ]
}
'
{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {}
        ]
      },
      "finishReason": "<string>",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123
  }
}
Cette page utilise la même opération generateContent que Générer du contenu (Gemini), avec le playground ci-dessus prérempli pour un chat en texte brut. Les notes ci-dessous décrivent les champs natifs Gemini que vous pouvez ajouter à generationConfig pour générer ou modifier des images avec des contrôles de réponse spécifiques au fournisseur.
Définissez generationConfig.responseModalities sur ["IMAGE"] pour demander une sortie image, puis utilisez generationConfig.imageConfig pour contrôler le ratio d’aspect et la taille de sortie.

​
Champs de requête natifs Gemini

ChampTypeRequisDescription
generationConfig.responseModalitiesarrayOuiTableau des modalités demandées, par exemple ["IMAGE"].
generationConfig.imageConfigobjectNonObjet de configuration d’image.
generationConfig.imageConfig.aspectRatiostringNonRatio d’aspect de l’image générée, par exemple 1:1.
generationConfig.imageConfig.imageSizestringNonTaille de sortie de l’image, par exemple 1024x1024.
Utilisez un modèle capable de génération d’images tel que gemini-2.0-flash-preview-image-generation dans le paramètre de chemin model.

​
Exemple : générer une image

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "A photorealistic image of a corgi wearing sunglasses on a beach." }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1024x1024"
    }
  }
}

​
Champs de réponse

La réponse suit la forme standard generateContent. Lorsqu’une sortie image est demandée, les parts renvoyés contiennent des données image inline :
​
candidates
array
Réponses candidates renvoyées par le modèle.
​
usageMetadata
object
Métadonnées d’utilisation des tokens, notamment promptTokenCount, candidatesTokenCount et totalTokenCount.

​
Exemple de réponse

200
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64-encoded-image-bytes>"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 14,
    "candidatesTokenCount": 0,
    "totalTokenCount": 14
  }
}

Autorisations

​
Authorization
string
header
requis

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

Paramètres de chemin

​
model
string
requis

Target model ID, such as gemini-1.5-pro.

Corps

application/json
​
contents
object[]

Input content array with role and parts.

​
generationConfig
object

Generation configuration.

Réponse

Generated content candidates.

​
candidates
object[]

Candidate responses returned by the model.

​
usageMetadata
object

Token accounting metadata.