Skip to main content
TokenLab n’expose cette route que pour les modèles qui annoncent un contrat Gemini natif et disposent d’une route upstream du même protocole ; aucun repli vers Chat Completions n’a lieu. Les noms ProtoJSON lowerCamelCase et les noms proto originaux snake_case sont tous deux officiels et sont conservés, y compris dans les requêtes mixtes. Les champs inconnus sont transmis au mieux et l’upstream décide de leur prise en charge.

Paramètres de chemin

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

Paramètres de requête

string
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

array
requis
Contenu de la conversation. Les valeurs role et tous les parts sont conservés tels qu’envoyés ; TokenLab n’effectue ni trim/lowercase, ni réécriture Base64, ni inférence MIME. inlineData / inline_data et fileData / file_data sont des graphies officielles, et TokenLab n’impose pas localement fileData.mimeType. Les identifiants Files ou Cache créés par TokenLab font l’objet d’un contrôle de propriété et conservent leur liaison upstream ; le fournisseur décide des autres règles média et outils.
object
Instruction système pour le modèle.
object
Configuration native de génération. Les noms lowerCamelCase tels que maxOutputTokens, candidateCount et thinkingConfig, ainsi que leurs équivalents snake_case, sont acceptés sans modification. TokenLab ne supprime pas thinkingConfig après un échec et n’impose pas de limite locale à candidateCount en streaming ; l’upstream décide des plages et combinaisons.
array
Paramètres des filtres de sécurité.

Réponse

array
Candidats de contenu générés.
object
Informations sur l’utilisation des tokens.

Exemples d’entrée multimodale

Pour les requêtes multimodales Gemini, placez les médias dans contents[].parts[] en utilisant soit des octets inline, soit des références de fichier basées sur une URL. Catégories de médias actuellement prises en charge dans le détails du modèle Gemini :
  • image
  • audio
  • vidéo
Pour les médias inline, utilisez inlineData ou inline_data et transmettez les octets du fichier encodés en Base64. Pour les médias via URL, utilisez fileData ou file_data et transmettez une URL publique en https.

Exemple d’entrée image

Exemple d’entrée audio

Exemple d’entrée vidéo

Exemple d’entrée vidéo

Exemple d’entrée audio