Générer du contenu

Utilisez les formats de requête et de réponse Gemini avec un modèle renvoyé par l'API Gemini Models. Le format ProtoJSON lowerCamelCase ainsi que les noms de champs correspondants en proto snake_case sont acceptés. Les champs optionnels et les valeurs pris en charge dépendent du modèle sélectionné.

Paramètres de cheminCopy Anchor Link

Paramètres de requêteCopy Anchor Link

AuthentificationCopy Anchor Link

Les endpoints Gemini prennent en charge plusieurs méthodes d'authentification :

• Paramètre de requête ?key=YOUR_API_KEY
• En-tête x-goog-api-key: YOUR_API_KEY
• En-tête Authorization: Bearer YOUR_API_KEY

Corps de la requêteCopy Anchor Link

Chaque champ en lowerCamelCase présenté ci-dessus peut également utiliser son orthographe officielle en proto snake_case, par exemple system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri et inline_data.mime_type.

Méthodes prises en chargeCopy Anchor Link

L'API compatible Gemini inclut la liste/récupération de modèles, generateContent, streamGenerateContent, countTokens, embedContent et batchEmbedContents. Les fonctionnalités Gemini Interactions et Live ne sont pas disponibles.

RéponseCopy Anchor Link

curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

Exemple d'entrée VisionCopy Anchor Link

Pour les requêtes multimodales Gemini, placez le média dans contents[].parts[] en utilisant soit des octets en ligne, soit des références de fichiers basées sur des URL.

Catégories de médias prises en charge dans les détails du modèle Gemini :

• image
• audio
• video

Pour les médias en ligne, utilisez inlineData ou inline_data et transmettez les octets du fichier encodés en Base64.

Pour les médias basés sur une URL, utilisez fileData ou file_data et transmettez une URL https publique.

Exemple d'entrée VidéoCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

Exemple d'entrée AudioCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}

Exemple d'entrée ImageCopy Anchor Link

Utilisez des octets d'image en ligne :

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Utilisez une URL d'image :

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "fileData": {
            "mimeType": "image/jpeg",
            "fileUri": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

Exemple d'entrée AudioCopy Anchor Link

Utilisez une URL audio :

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Transcribe and summarize this audio." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

Exemple d'entrée VidéoCopy Anchor Link

Utilisez une URL vidéo :

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Describe this video briefly." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

Interfaces associéesCopy Anchor Link

Lisez les détails du modèle sélectionné avant d'utiliser une autre interface. La disponibilité et les champs de requête dépendent du modèle.

Le comptage de tokens nécessite une clé API et n'est pas facturé. Le nombre d'entrées renvoyé est une estimation à des fins de planification ; utilisez l'utilisation finale de la réponse et le relevé de facturation pour le coût réel.

countTokens: contents / generateContentRequest

embedContent: content, taskType, title, outputDimensionality

batchEmbedContents: requests