Protocole Gemini

Envoyez du contenu au format Gemini generateContent.

Adresse du service

Cette page couvre la découverte des modèles Gemini REST natifs, la génération, le streaming et les embeddings. Utilisez le guide Gemini des images pour les paramètres d’image.

Modèles et découverte

Usage	Méthode	Chemin
Liste des modèles Gemini	GET	/v1beta/models
Liste compatible Gemini	GET	/v1/models

Génération de contenu

Usage	Méthode	Chemin
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

Embeddings

Usage	Méthode	Chemin
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Embeddings Gemini compatibles	POST	/v1/engines/{model}/embeddings

Requête minimale

Remplacez YOUR_MODEL par l’ID réel et laissez-le dans le chemin URL. Préférez x-goog-api-key: YOUR_API_KEY ; Bearer est aussi accepté. N’utilisez le paramètre key que si le client l’exige, car les URL peuvent être enregistrées.

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "Confirmez la connexion"}]}
    ]
  }'

Vérification

Une réponse réussie contient des candidats ou des embeddings. Utilisez streamGenerateContent pour le streaming et embedContent, batchEmbedContents ou le chemin compatible pour les embeddings. Pour un 404, vérifiez l’ID, le chemin et le groupe Key.