Gemini natif
Générer du contenu
Génère du contenu au format de l'API Google Gemini
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
Nom du modèle (par exemple, gemini-2.5-pro, gemini-3.5-flash).
Paramètres de requête
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
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.
Instruction système pour le modèle.
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.
Paramètres des filtres de sécurité.
Outils Gemini tels que functionDeclarations. Les types d'outils pris en charge dépendent du modèle.
Configuration des outils telle que functionCallingConfig.
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
Candidats de contenu généré.
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
{
"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.
Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de chemin
Nom du modèle (par ex., gemini-2.5-pro)
Paramètres de requête
Clé API (alternative à l'authentification par en-tête)
En-têtes
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