GetRouterDocs
  • Français

    • API compatible Gemini

    GetRouter expose des endpoints compatibles Gemini pour lister les modèles et générer du contenu.

    GET  https://getrouter.ai/v1beta/models
POST https://getrouter.ai/v1beta/models/{model}:generateContent

    Remplacez {model} par l’ID exact du modèle.

    Lister les modèles

    curl https://getrouter.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"

    La réponse utilise une structure de liste de modèles compatible Gemini.

    Générer du contenu

    curl "https://getrouter.ai/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Explain API routing in two sentences."}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.4,
      "maxOutputTokens": 256
    }
  }'

    Le contenu généré est renvoyé dans la structure candidates compatible Gemini. Les informations d’utilisation peuvent être renvoyées dans usageMetadata.

    Champs de la requête

    Le schéma de generateContent comprend :

    • contents avec les rôles user ou model
    • des parties de texte
    • des parties de données en ligne avec mimeType et data encodé en Base64
    • generationConfig, notamment la température, top-p, top-k, le nombre maximal de tokens en sortie et les séquences d’arrêt
    • safetySettings
    • tools
    • systemInstruction

    La prise en charge varie selon le modèle. Commencez avec du contenu uniquement textuel avant d’ajouter des entrées multimodales, des outils ou une configuration propre au modèle.

    Exemple de données en ligne

    Un modèle multimodal compatible peut accepter une partie de données en ligne :

    {
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "Describe the attached image."},
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ]
}

    Charges utiles Gemini pour la génération d’images

    Le même chemin generateContent peut exposer, pour les modèles compatibles, une configuration de réponse orientée image, notamment les modalités de réponse et la configuration de l’image. Pour ces requêtes, utilisez la documentation exacte du modèle et l’exemple de la référence de l’API.

    Notes de compatibilité

    • Les clients compatibles Gemini peuvent construire les URL différemment des clients compatibles OpenAI.
    • Ne saisissez pas https://getrouter.ai/v1 dans un client Gemini, sauf si son guide d’intégration demande explicitement cette valeur.
    • Vérifiez si le client attend une racine d’API, un chemin de version d’API ou l’endpoint complet d’une opération.

    Étapes suivantes