> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# API tous modèles Gemini - format API native
> Sélectionnez le modèle de texte Gemini à appeler via `{model}` dans le chemin (voir le tableau de correspondance du paramètre `model` pour toutes les valeurs possibles).
- Utilise le format Google Native API, retourne le contenu de la conversation de manière synchrone
- **Entrée texte brut / multimodale** : entrée mixte texte + image / audio / vidéo
- **Streaming** : remplacez `generateContent` par `streamGenerateContent` dans le chemin (ajoutez `?alt=sse` pour obtenir du SSE)
---
**Spécifications et différences des modèles**
- **Paramètres d'échantillonnage** `temperature` / `topP` / `topK` : identiques pour toute la série Gemini 3.x, les valeurs personnalisées n'affectent pas la sortie ; `topK` est directement rejeté par la passerelle (non transmis en amont), et `temperature` / `topP` renvoient une erreur 400 si elles sont hors de la plage autorisée.
- **Contrôle du raisonnement** : la série Gemini 3.x utilise `thinkingConfig.thinkingLevel` (voir le paramètre `thinkingLevel` pour les niveaux pris en charge et la valeur par défaut de chaque modèle) ; la série Gemini 2.5 utilise `thinkingConfig.thinkingBudget` (entier, `0`=désactivé). Les deux sont mutuellement exclusifs.
- **Appel de fonction** : le `FunctionResponse` de Gemini 3.x doit renvoyer l'`id` et le `name` correspondant au `FunctionCall` associé, sinon une erreur est générée.
- **Rôle du dernier tour** : le `role` du dernier message ne peut pas être `model` (Gemini 3.5+ génère une erreur).
- **Limite de tokens** : `gemini-3.6-flash` / `gemini-3.5-flash-lite` contexte 1,048,576, sortie maximale 65,536 ; les autres modèles selon leurs propres spécifications.
**Streaming** : Remplacez `generateContent` par `streamGenerateContent` dans l'URL. Les paramètres du corps de requête sont identiques. Les réponses seront retournées en blocs de streaming. Voir la section « Réponse en streaming » ci-dessous pour le format de réponse.
**BaseURL** : La BaseURL par défaut est `https://direct.evolink.ai`, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. `https://api.evolink.ai` est le point d'accès principal pour les services multimodaux et sert d'adresse de secours pour les modèles de texte.
## OpenAPI
````yaml fr/api-manual/language-series/gemini/native-api/native-api-reference.json POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
title: API tous modèles Gemini (format API native)
description: >-
Interface native unifiée pour toute la gamme de modèles de texte Gemini ;
sélectionnez le modèle spécifique via model dans le chemin, prend en charge
les entrées texte et multimodales (image / audio / vidéo).
license:
name: MIT
version: 1.0.0
servers:
- url: https://direct.evolink.ai
description: Production (recommandée)
- url: https://api.evolink.ai
description: URL alternative
security:
- bearerAuth: []
tags:
- name: Génération de contenu
description: APIs liées à la génération de contenu Gemini AI
paths:
/v1beta/models/{model}:generateContent:
post:
tags:
- Génération de contenu
summary: Génération de contenu Gemini (tous modèles)
description: >-
Sélectionnez le modèle de texte Gemini à appeler via `{model}` dans le
chemin (voir le tableau de correspondance du paramètre `model` pour
toutes les valeurs possibles).
- Utilise le format Google Native API, retourne le contenu de la
conversation de manière synchrone
- **Entrée texte brut / multimodale** : entrée mixte texte + image /
audio / vidéo
- **Streaming** : remplacez `generateContent` par
`streamGenerateContent` dans le chemin (ajoutez `?alt=sse` pour obtenir
du SSE)
---
**Spécifications et différences des modèles**
- **Paramètres d'échantillonnage** `temperature` / `topP` / `topK` :
identiques pour toute la série Gemini 3.x, les valeurs personnalisées
n'affectent pas la sortie ; `topK` est directement rejeté par la
passerelle (non transmis en amont), et `temperature` / `topP` renvoient
une erreur 400 si elles sont hors de la plage autorisée.
- **Contrôle du raisonnement** : la série Gemini 3.x utilise
`thinkingConfig.thinkingLevel` (voir le paramètre `thinkingLevel` pour
les niveaux pris en charge et la valeur par défaut de chaque modèle) ;
la série Gemini 2.5 utilise `thinkingConfig.thinkingBudget` (entier,
`0`=désactivé). Les deux sont mutuellement exclusifs.
- **Appel de fonction** : le `FunctionResponse` de Gemini 3.x doit
renvoyer l'`id` et le `name` correspondant au `FunctionCall` associé,
sinon une erreur est générée.
- **Rôle du dernier tour** : le `role` du dernier message ne peut pas
être `model` (Gemini 3.5+ génère une erreur).
- **Limite de tokens** : `gemini-3.6-flash` / `gemini-3.5-flash-lite`
contexte 1,048,576, sortie maximale 65,536 ; les autres modèles selon
leurs propres spécifications.
operationId: geminiGenerateContent
parameters:
- name: model
in: path
required: true
description: >-
Sélectionnez le modèle de texte Gemini à appeler :
| Modèle ID | Série | Positionnement |
|---|---|---|
| `gemini-3.6-flash` | 3.6 Flash | Orchestration multi-étapes /
Refactorisation de code / Raisonnement général |
| `gemini-3.5-flash` | 3.5 Flash | Flash générique |
| `gemini-3.5-flash-lite` | 3.5 Flash-Lite | Faible coût / Haut
débit / Agent léger |
| `gemini-3.1-pro-preview` | 3.1 Pro (Preview) | Raisonnement avancé
|
| `gemini-3.1-pro-preview-customtools` | 3.1 Pro · CustomTools |
Raisonnement avancé + Outils personnalisés |
| `gemini-3.1-flash-lite-preview` | 3.1 Flash-Lite (Preview) |
Faible coût |
| `gemini-3-pro-preview` | 3.0 Pro (Preview) | Raisonnement avancé |
| `gemini-3-flash-preview` | 3.0 Flash (Preview) | Flash générique |
| `gemini-2.5-pro` | 2.5 Pro | Raisonnement avancé |
| `gemini-2.5-flash` | 2.5 Flash | Flash générique |
| `gemini-2.5-flash-lite` | 2.5 Flash-Lite | Faible coût |
schema:
type: string
enum:
- gemini-3.6-flash
- gemini-3.5-flash
- gemini-3.5-flash-lite
- gemini-3.1-pro-preview
- gemini-3.1-pro-preview-customtools
- gemini-3.1-flash-lite-preview
- gemini-3-pro-preview
- gemini-3-flash-preview
- gemini-2.5-pro
- gemini-2.5-flash
- gemini-2.5-flash-lite
example: gemini-3.6-flash
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateContentRequest'
examples:
simple_text:
summary: Conversation textuelle à tour unique
value:
contents:
- role: user
parts:
- text: Please introduce yourself
multi_turn:
summary: Conversation multi-tours (compréhension du contexte)
value:
contents:
- role: user
parts:
- text: What is Python?
- role: model
parts:
- text: Python is a high-level programming language...
- role: user
parts:
- text: What are its advantages?
audio_analysis:
summary: Analyse audio
value:
contents:
- role: user
parts:
- text: >-
Please analyze this song audio and answer: 1. Song
source and artist 2. Song mood 3. Complete lyrics
output
- fileData:
mimeType: audio/mp3
fileUri: https://example.com/audio.mp3
image_understanding:
summary: Compréhension d'image
value:
contents:
- role: user
parts:
- text: >-
Please describe the scene and main elements in this
image in detail
- fileData:
mimeType: image/jpeg
fileUri: https://example.com/image.jpg
multi_file:
summary: Entrée multi-fichiers (mixte)
value:
contents:
- role: user
parts:
- text: >-
Compare the relationship between these two images
and this audio
- fileData:
mimeType: image/jpeg
fileUri: https://example.com/image1.jpg
- fileData:
mimeType: image/png
fileUri: https://example.com/image2.png
- fileData:
mimeType: audio/mp3
fileUri: https://example.com/audio.mp3
responses:
'200':
description: >-
Contenu généré avec succès
**Description du format de réponse** :
- Lors de l'utilisation du endpoint `generateContent`, retourne
`GenerateContentResponse` (retourne la réponse complète en une fois)
- Lors de l'utilisation du endpoint `streamGenerateContent`,
retourne `StreamGenerateContentResponse` (réponse en streaming,
retourne le contenu par morceaux)
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/GenerateContentResponse'
- $ref: '#/components/schemas/StreamGenerateContentResponse'
'400':
description: Paramètres de requête invalides
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 400
message: Paramètres de requête invalides
type: invalid_request_error
'401':
description: Non autorisé, jeton invalide ou expiré
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 401
message: Invalid or expired token
type: authentication_error
'402':
description: Quota insuffisant, recharge requise
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 402
message: Quota insuffisant
type: insufficient_quota_error
fallback_suggestion: https://evolink.ai/dashboard/billing
'403':
description: Accès refusé
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 403
message: Access denied for this model
type: permission_error
'404':
description: Ressource introuvable
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 404
message: Model not found
type: not_found_error
'413':
description: Corps de la requête trop volumineux, fichier trop volumineux
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 413
message: Corps de la requête trop volumineux
type: request_too_large_error
fallback_suggestion: reduce file size
'429':
description: Limite de débit dépassée
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 429
message: Limite de débit dépassée
type: rate_limit_error
fallback_suggestion: retry after 60 seconds
'500':
description: Erreur interne du serveur
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 500
message: Erreur interne du serveur
type: internal_server_error
fallback_suggestion: try again later
'502':
description: Erreur du service en amont
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 502
message: Upstream AI service unavailable
type: upstream_error
fallback_suggestion: try again later
'503':
description: Service temporairement indisponible
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 503
message: Service temporairement indisponible
type: service_unavailable_error
fallback_suggestion: retry after 30 seconds
components:
schemas:
GenerateContentRequest:
type: object
required:
- contents
properties:
contents:
type: array
description: >-
List of conversation contents, supports multi-turn dialogue and
multimodal input
items:
$ref: '#/components/schemas/Content'
minItems: 1
generationConfig:
$ref: '#/components/schemas/GenerationConfig'
description: Generation configuration parameters (optional)
systemInstruction:
$ref: '#/components/schemas/Content'
description: System instruction (optional), mainly text content
tools:
type: array
items:
type: object
description: >-
List of tools the model can call, such as function calling or code
execution
toolConfig:
type: object
description: Tool calling configuration (optional)
safetySettings:
type: array
items:
type: object
description: Safety settings list (optional)
cachedContent:
type: string
description: Cached content name, in the form cachedContents/{cachedContent}
GenerateContentResponse:
title: Réponse synchrone
type: object
properties:
candidates:
type: array
description: List of candidate responses
items:
$ref: '#/components/schemas/Candidate'
promptFeedback:
$ref: '#/components/schemas/PromptFeedback'
usageMetadata:
$ref: '#/components/schemas/UsageMetadata'
modelVersion:
type: string
description: Model version
example: gemini-3.6-flash
responseId:
type: string
description: Response ID
example: l-LoaPu0BPmo1dkP6ZPHiQc
StreamGenerateContentResponse:
title: Réponse en flux
type: object
description: |-
Fragment de réponse en streaming
**Fragment intermédiaire** :
```json
{
"candidates": [
{
"content": {
"role": "model",
"parts": [{ "text": "Texte partiel..." }]
}
}
],
"usageMetadata": {
"trafficType": "ON_DEMAND"
},
"modelVersion": "gemini-3.6-flash",
"createTime": "2025-10-10T10:40:23.072315Z",
"responseId": "xxx"
}
```
**Dernier fragment** :
```json
{
"candidates": [
{
"content": {
"role": "model",
"parts": [{ "text": "Dernier fragment de texte" }]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 4,
"candidatesTokenCount": 522,
"totalTokenCount": 2191,
"trafficType": "ON_DEMAND"
},
"modelVersion": "gemini-3.6-flash",
"createTime": "2025-10-10T10:40:23.072315Z",
"responseId": "xxx"
}
```
properties:
candidates:
type: array
description: >-
Liste des réponses candidates (le mode streaming n'inclut pas index
et safetyRatings)
items:
$ref: '#/components/schemas/StreamCandidate'
usageMetadata:
type: object
description: >-
Statistiques d'utilisation (les fragments intermédiaires n'ont que
trafficType, le dernier fragment contient les statistiques
complètes)
properties:
promptTokenCount:
type: integer
description: >-
Nombre de tokens dans le contenu d'entrée (dernier fragment
uniquement)
example: 4
candidatesTokenCount:
type: integer
description: >-
Nombre de tokens dans le contenu de sortie (dernier fragment
uniquement)
example: 522
totalTokenCount:
type: integer
description: Nombre total de jetons (dernier bloc uniquement)
example: 2191
trafficType:
type: string
description: Type de trafic
example: ON_DEMAND
cachedContentTokenCount:
type: integer
description: Number of cached content tokens (last chunk only)
example: 0
modelVersion:
type: string
description: Version du modèle
example: gemini-3.6-flash
createTime:
type: string
format: date-time
description: Heure de création
example: '2025-10-10T10:40:23.072315Z'
responseId:
type: string
description: ID de réponse
example: l-LoaPu0BPmo1dkP6ZPHiQc
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: integer
description: Code d'erreur de statut HTTP
message:
type: string
description: Description de l'erreur
type:
type: string
description: Type d'erreur
fallback_suggestion:
type: string
description: Suggestion lorsqu'une erreur se produit
Content:
type: object
required:
- role
- parts
properties:
role:
type: string
description: |-
Rôle du contenu
- `user` : Entrée utilisateur
- `model` : Réponse du modèle IA (pour conversation multi-tours)
enum:
- user
- model
example: user
parts:
type: array
description: >-
Content parts list, supports text, file data, inline data, function
calls, function responses, and code execution results
items:
$ref: '#/components/schemas/Part'
minItems: 1
GenerationConfig:
type: object
description: Generation configuration parameters
properties:
temperature:
type: number
description: >-
Température d'échantillonnage, contrôle le caractère aléatoire de la
sortie
**Description** :
- Valeurs basses (ex. 0.2) : Sortie plus déterministe et ciblée
- Valeurs élevées (ex. 1.5) : Sortie plus aléatoire et créative
⚠️ **Identique pour toute la série Gemini 3.x** (ne varie pas selon
le modèle) : les valeurs personnalisées dans la plage autorisée
n'affectent pas la sortie ; toute valeur hors de la plage autorisée
de ce paramètre renvoie une erreur 400, au lieu d'être ignorée
silencieusement.
minimum: 0
maximum: 2
example: 0.7
maxOutputTokens:
type: integer
description: >-
Nombre maximum de tokens pour la réponse générée
**Description :**
- Une valeur trop petite peut entraîner une troncature de la réponse
`gemini-3.6-flash` / `gemini-3.5-flash-lite` limite de 65,536 tokens
; les autres modèles selon leurs propres spécifications.
minimum: 1
example: 2000
topP:
type: number
description: >-
Paramètre de Nucleus Sampling
**Description** :
- Contrôle l'échantillonnage à partir des tokens dont la probabilité
cumulative est parmi les plus élevées
- Par exemple, 0.9 signifie sélectionner parmi les tokens dont la
probabilité cumulative atteint 90%
- Valeur par défaut : 0.95
**Recommandation** : ne pas ajuster temperature et topP
simultanément
⚠️ **Identique pour toute la série Gemini 3.x** (ne varie pas selon
le modèle) : les valeurs personnalisées dans la plage autorisée
n'affectent pas la sortie ; toute valeur hors de la plage autorisée
de ce paramètre renvoie une erreur 400, au lieu d'être ignorée
silencieusement.
minimum: 0
maximum: 1
example: 0.9
topK:
type: integer
description: >-
Paramètre d'échantillonnage Top-K
**Description** :
- Par exemple, 10 signifie limiter chaque échantillonnage aux 10
tokens les plus probables
- Des valeurs plus petites rendent la sortie plus ciblée
- Valeur par défaut : 64
⚠️ Ce paramètre est directement rejeté par la passerelle et n'est
pas transmis en amont ; il est sans effet sur tous les modèles
Gemini 3.x.
minimum: 1
example: 40
responseMimeType:
type: string
description: >-
MIME type of generated candidate content, for example text/plain or
application/json
example: application/json
responseSchema:
type: object
description: >-
Output schema definition for generated content (JSON mode /
structured output)
responseJsonSchema:
type: object
description: >-
JSON Schema for generated content (useful for more complex
structured output)
thinkingConfig:
type: object
description: >-
Configuration du raisonnement, contrôle le comportement de
raisonnement du modèle.
- **Série Gemini 3.x** : utilise `thinkingLevel` (voir le paramètre
`thinkingLevel` pour les niveaux pris en charge et la valeur par
défaut de chaque modèle)
- **Série Gemini 2.5** : utilise `thinkingBudget`
⚠️ `thinkingLevel` et `thinkingBudget` sont mutuellement exclusifs ;
les transmettre simultanément génère une erreur.
properties:
thinkingLevel:
type: string
enum:
- minimal
- low
- medium
- high
description: >-
Niveau de raisonnement, contrôle la profondeur du raisonnement
(insensible à la casse) :
- `minimal` : raisonnement quasi nul, destiné aux scénarios à
haut débit / faible latence (classification, extraction,
routage, etc.)
- `low` : raisonnement réduit, adapté aux tâches simples
- `medium` : équilibre entre qualité et vitesse, adapté aux
tâches de complexité moyenne
- `high` : raisonnement approfondi multi-étapes, adapté au
raisonnement complexe, aux mathématiques et au codage
**Pris en charge uniquement par la série Gemini 3.x**, les
niveaux pris en charge et la valeur par défaut diffèrent selon
les modèles (la série Gemini 2.5 utilise plutôt
`thinkingBudget`) :
| Modèle | Niveaux pris en charge | Par défaut |
|---|---|---|
| `gemini-3.6-flash` | `minimal` / `low` / `medium` / `high` |
`medium` |
| `gemini-3.5-flash` | `minimal` / `low` / `medium` / `high` |
`medium` |
| `gemini-3.5-flash-lite` | `minimal` / `low` / `medium` /
`high` | `minimal` |
| `gemini-3.1-flash-lite-preview` | `minimal` / `low` / `medium`
/ `high` | `minimal` |
| `gemini-3-flash-preview` | `minimal` / `low` / `medium` /
`high` | `medium` |
| `gemini-3.1-pro-preview` | `low` / `medium` / `high` | `high`
|
| `gemini-3.1-pro-preview-customtools` | `low` / `medium` /
`high` | `high` |
| `gemini-3-pro-preview` | `low` / `medium` / `high` | `high` |
Transmettre un niveau non pris en charge par le modèle génère
une erreur (par ex., transmettre `minimal` à la série Pro
renvoie une erreur 400 en amont).
example: minimal
thinkingBudget:
type: integer
description: >-
Budget de tokens de raisonnement, utilisé par la **série Gemini
2.5** (`gemini-2.5-flash` / `gemini-2.5-flash-lite` /
`gemini-2.5-pro`) : `0`=raisonnement désactivé, `-1`=budget
dynamique, entier positif=budget fixe (la plage de valeurs
exacte dépend de chaque modèle). Mutuellement exclusif avec
`thinkingLevel`.
example: -1
Candidate:
type: object
properties:
content:
$ref: '#/components/schemas/ContentResponse'
finishReason:
type: string
description: Finish reason
enum:
- FINISH_REASON_UNSPECIFIED
- STOP
- MAX_TOKENS
- SAFETY
- RECITATION
- LANGUAGE
- OTHER
- BLOCKLIST
- PROHIBITED_CONTENT
- SPII
- MALFORMED_FUNCTION_CALL
- IMAGE_SAFETY
- IMAGE_PROHIBITED_CONTENT
- IMAGE_OTHER
- NO_IMAGE
- IMAGE_RECITATION
- UNEXPECTED_TOOL_CALL
- TOO_MANY_TOOL_CALLS
- MISSING_THOUGHT_SIGNATURE
example: STOP
index:
type: integer
description: Index du candidat
example: 0
safetyRatings:
type: array
nullable: true
description: Évaluations de sécurité
items:
type: object
PromptFeedback:
type: object
properties:
safetyRatings:
type: array
nullable: true
description: Évaluations de sécurité de l'invite
items:
type: object
UsageMetadata:
type: object
description: Statistiques d'utilisation
properties:
promptTokenCount:
type: integer
description: Nombre de tokens dans le contenu d'entrée
example: 4
candidatesTokenCount:
type: integer
description: Nombre de tokens dans le contenu de sortie
example: 611
totalTokenCount:
type: integer
description: Nombre total de jetons
example: 2422
thoughtsTokenCount:
type: integer
description: Nombre de tokens de raisonnement
example: 1807
promptTokensDetails:
type: array
description: Informations détaillées sur les jetons d'entrée (par modalité)
items:
$ref: '#/components/schemas/TokenDetail'
cachedContentTokenCount:
type: integer
description: Number of cached content tokens
example: 0
StreamCandidate:
type: object
description: Stream response candidate (more simplified than regular response)
properties:
content:
$ref: '#/components/schemas/ContentResponse'
finishReason:
type: string
description: Finish reason (only included in last chunk)
enum:
- FINISH_REASON_UNSPECIFIED
- STOP
- MAX_TOKENS
- SAFETY
- RECITATION
- LANGUAGE
- OTHER
- BLOCKLIST
- PROHIBITED_CONTENT
- SPII
- MALFORMED_FUNCTION_CALL
- IMAGE_SAFETY
- IMAGE_PROHIBITED_CONTENT
- IMAGE_OTHER
- NO_IMAGE
- IMAGE_RECITATION
- UNEXPECTED_TOOL_CALL
- TOO_MANY_TOOL_CALLS
- MISSING_THOUGHT_SIGNATURE
example: STOP
Part:
oneOf:
- $ref: '#/components/schemas/TextPart'
- $ref: '#/components/schemas/FilePart'
- $ref: '#/components/schemas/InlineDataPart'
- $ref: '#/components/schemas/FunctionCallPart'
- $ref: '#/components/schemas/FunctionResponsePart'
- $ref: '#/components/schemas/ExecutableCodePart'
- $ref: '#/components/schemas/CodeExecutionResultPart'
description: >-
Content part union type. The thoughtSignature returned by thinking
models must be echoed back in the next turn.
ContentResponse:
type: object
properties:
role:
type: string
description: Rôle de réponse
enum:
- model
example: model
parts:
type: array
description: >-
Response content parts, supports text, inline data, function calls,
function responses, and code execution results
items:
$ref: '#/components/schemas/Part'
TokenDetail:
type: object
description: Détails des jetons (statistiques par modalité)
properties:
modality:
type: string
description: Content modality type
enum:
- MODALITY_UNSPECIFIED
- TEXT
- IMAGE
- AUDIO
- VIDEO
- DOCUMENT
example: TEXT
tokenCount:
type: integer
description: Nombre de tokens pour cette modalité
example: 4
TextPart:
title: Entrée texte
type: object
required:
- text
properties:
text:
type: string
description: Contenu texte
example: |-
Hello! I'm pleased to introduce myself.
I'm a large language model, trained and developed by Google...
thought:
type: boolean
description: Whether this is thought content
thoughtSignature:
type: string
description: Thought signature, must be echoed back in the next turn
example:
FilePart:
title: Entrée multimodale
type: object
required:
- fileData
properties:
fileData:
type: object
required:
- mimeType
- fileUri
properties:
mimeType:
type: string
description: |-
Type MIME du fichier
**Types pris en charge** :
**Image** :
- `image/jpeg`, `image/png`
- Taille maximale par image : 10 MB
**Audio** :
- `audio/mp3`
- Taille maximale par fichier : 10 MB
- Durée recommandée : pas plus de 10 minutes
**Vidéo** :
- `video/mp4`
- Taille maximale par fichier : 50 MB
- Durée recommandée : pas plus de 180 secondes
**Document** :
- `application/pdf`
- Taille maximale par fichier : 20 MB
example: audio/mp3
fileUri:
type: string
format: uri
description: >-
Adresse URI du fichier
**Exigences** :
- Doit être une URL accessible publiquement
- L'URL doit se terminer par une extension de fichier (par ex.,
.mp3, .jpg) et doit correspondre au paramètre mimeType
example: https://example.com/audio.mp3
InlineDataPart:
title: Inline Data
type: object
required:
- inlineData
properties:
inlineData:
$ref: '#/components/schemas/BlobData'
thought:
type: boolean
description: Whether this is thought content
thoughtSignature:
type: string
description: Thought signature, must be echoed back in the next turn
example:
FunctionCallPart:
title: Function Call
type: object
required:
- functionCall
properties:
functionCall:
$ref: '#/components/schemas/FunctionCall'
thought:
type: boolean
description: Whether this is thought content
thoughtSignature:
type: string
description: Thought signature, must be echoed back in the next turn
example:
FunctionResponsePart:
title: Function Response
type: object
required:
- functionResponse
properties:
functionResponse:
$ref: '#/components/schemas/FunctionResponse'
ExecutableCodePart:
title: Generated Code
type: object
required:
- executableCode
properties:
executableCode:
$ref: '#/components/schemas/ExecutableCode'
CodeExecutionResultPart:
title: Code Execution Result
type: object
required:
- codeExecutionResult
properties:
codeExecutionResult:
$ref: '#/components/schemas/CodeExecutionResult'
BlobData:
type: object
properties:
mimeType:
type: string
description: IANA MIME type
example: image/png
data:
type: string
format: byte
description: Base64-encoded raw media data
required:
- mimeType
- data
FunctionCall:
type: object
required:
- name
- args
properties:
name:
type: string
description: Function name
example: get_weather
args:
type: object
description: Function arguments
id:
type: string
description: >-
ID d'appel. Généré par le modèle sur Gemini 3.x, utilisé pour
l'appariement des appels de fonction parallèles.
example: fc-abc123
FunctionResponse:
type: object
required:
- name
- response
properties:
name:
type: string
description: Function name
example: get_weather
parts:
type: array
description: Optional multimodal response parts
items:
$ref: '#/components/schemas/FunctionResponseMediaPart'
response:
type: object
description: Function response payload
id:
type: string
description: >-
ID d'appel correspondant au `FunctionCall` (certaines documentations
/ SDK l'appellent `call_id`). **Doit être renvoyé sur Gemini 3.x**,
utilisé avec le `name` pour l'appariement, sinon une erreur est
générée.
example: fc-abc123
ExecutableCode:
type: object
required:
- language
- code
properties:
language:
type: string
description: Code language
example: python
code:
type: string
description: Generated code
CodeExecutionResult:
type: object
required:
- outcome
properties:
outcome:
type: string
description: Code execution result
enum:
- OUTCOME_UNSPECIFIED
- OUTCOME_OK
- OUTCOME_FAILED
- OUTCOME_DEADLINE_EXCEEDED
example: OUTCOME_OK
output:
type: string
description: Standard output, error output, or other description
FunctionResponseMediaPart:
type: object
required:
- inlineData
properties:
inlineData:
$ref: '#/components/schemas/BlobData'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
##Toutes les API nécessitent une authentification Bearer Token##
**Obtenir une clé API :**
Visitez la [Page de gestion des clés
API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API
**Ajouter à l'en-tête de requête :**
```
Authorization: Bearer YOUR_API_KEY
```
````