TokenLab

Gemini natif

Générer du contenu

Génère du contenu au format de l'API Google Gemini

POST
/v1beta/models/{model}:generateContent

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

Paramètres de chemin

modelstringpathrequis

Nom du modèle (par exemple, gemini-2.5-pro, gemini-3.5-flash).

Paramètres de requête

keystringquery

Clé API (alternative à l'authentification par en-tête).

Authentification

Les points de terminaison 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ête

contentsarrayrequis

Contenu de la conversation avec parts et un role facultatif. Les parties multimédias utilisent inlineData / inline_data ou fileData / file_data. Les fichiers et identifiants de cache créés par TokenLab ne peuvent être utilisés que dans le Workspace auquel ils appartiennent.

systemInstructionobject

Instruction système pour le modèle.

generationConfigobject

Paramètres de génération tels que temperature, topP, topK, maxOutputTokens, stopSequences, candidateCount, responseModalities, responseMimeType, responseSchema et thinkingConfig. Les noms correspondants en snake_case sont également acceptés. Les valeurs et combinaisons prises en charge dépendent du modèle.

safetySettingsarray

Paramètres des filtres de sécurité.

toolsarray

Outils Gemini tels que functionDeclarations. Les types d'outils pris en charge dépendent du modèle.

toolConfigobject

Configuration des outils telle que functionCallingConfig.

cachedContentstring

Nom du contenu mis en cache créé avec Créer un contenu en cache, par exemple cachedContents/abc123. Il ne fonctionne que dans le Workspace qui l'a créé.

Chaque champ en lowerCamelCase présenté ci-dessus peut également utiliser son orthographe proto officielle en 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 charge

L'API compatible Gemini comprend Lister les modèles, Obtenir un modèle, generateContent, streamGenerateContent, countTokens, Files et le contenu en cache. Gemini Interactions et Live ne sont pas disponibles.

Consultez la réponse Obtenir un modèle du modèle avant de l'appeler : supportedGenerationMethods liste les actions acceptées par ce modèle.

Réponse

candidatesarray

Candidats de contenu généré.

usageMetadataobject

Informations sur l'utilisation des tokens.

Requête

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
    }
  }'

Erreurs

  • 400 INVALID_ARGUMENT : le corps de la requête n'est pas valide, ou le modèle n'accepte pas les requêtes Gemini.
  • 401 UNAUTHENTICATED : la clé API est manquante ou invalide.
  • 402 RESOURCE_EXHAUSTED : le solde est insuffisant pour cette requête.
  • 503 UNAVAILABLE : aucun routage n'est disponible pour le modèle actuellement. Réessayez plus tard.

Entrée multimédia

Placez les éléments multimédias dans contents[].parts[] sous forme d'octets Base64 intégrés (inlineData ou inline_data) ou sous forme d'URL https publique (fileData ou file_data). Les images, l'audio et la vidéo sont pris en charge.

Image

Utilisez des octets d'image intégrés :

{
  "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"
          }
        }
      ]
    }
  ]
}

Audio

Utilisez une URL audio, ici avec les noms proto en snake_case :

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

Vidéo

Utilisez une URL vidéo :

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

Réponse

Response
{
  "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
  }
}

Décompte de tokens et embeddings

Compter les tokens (POST /v1beta/models/{model}:countTokens) nécessite une clé API et n'est pas facturé. Utilisez ce décompte pour la planification ; la facturation d'une requête de génération provient de la propriété usageMetadata de cette réponse.

Les modèles d'embedding utilisent Créer un embedding (POST /v1/embeddings). N'appelez embedContent ou batchEmbedContents que pour un modèle dont la réponse Obtenir un modèle les répertorie dans supportedGenerationMethods.

Autorisation

AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

model*string

Nom du modèle (par ex., gemini-2.5-pro)

Paramètres de requête

key?string

Clé API (alternative à l'authentification par en-tête)

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

application/json

Requête native Gemini GenerateContent. Les noms ProtoJSON lowerCamelCase et proto snake_case originaux sont tous deux acceptés et préservés, y compris les requêtes mixtes. Si les deux orthographes d'un champ sont présentes, TokenLab ne les fusionne pas et ne choisit pas de priorité locale. Les champs inconnus sont transmis au mieux.

Réponse

application/json

application/json

application/json

application/json

application/json

application/json