> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Gemini 3.5 Flash - API Native - Démarrage Rapide
> - Utiliser le format Google Native API pour appeler le modèle gemini-3.5-flash
- Mode de traitement synchrone, réponse en temps réel
- Paramètres minimaux pour un démarrage rapide
- 💡 Besoin de plus de fonctionnalités ? Consultez la [Référence API complète](./native-api-reference)
**Streaming** : Remplacez `generateContent` par `streamGenerateContent` dans l'URL pour activer les réponses en streaming et recevoir le contenu en temps réel par blocs.
**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-3.5-flash/native-api/native-api-quickstart.json POST /v1beta/models/gemini-3.5-flash:generateContent
openapi: 3.1.0
info:
title: API Native Gemini - Démarrage Rapide
description: >-
Démarrez avec Google Gemini Native API, complétez votre première
conversation IA en 5 minutes
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 de génération de contenu Gemini AI
paths:
/v1beta/models/gemini-3.5-flash:generateContent:
post:
tags:
- Génération de contenu
summary: Chat rapide gemini-3.5-flash
description: >-
- Utiliser le format Google Native API pour appeler le modèle
gemini-3.5-flash
- Mode de traitement synchrone, réponse en temps réel
- Paramètres minimaux pour un démarrage rapide
- 💡 Besoin de plus de fonctionnalités ? Consultez la [Référence API
complète](./native-api-reference)
operationId: generateContentQuick
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateContentQuickRequest'
responses:
'200':
description: Contenu généré avec succès
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateContentResponse'
'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 authentifié, 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
'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:
GenerateContentQuickRequest:
type: object
required:
- contents
properties:
contents:
type: array
description: Liste du contenu de la conversation
items:
$ref: '#/components/schemas/ContentSimple'
minItems: 1
example:
- role: user
parts:
- text: Hello, please introduce yourself
GenerateContentResponse:
type: object
properties:
candidates:
type: array
description: Liste des réponses candidates
items:
$ref: '#/components/schemas/Candidate'
promptFeedback:
$ref: '#/components/schemas/PromptFeedback'
usageMetadata:
$ref: '#/components/schemas/UsageMetadata'
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 de repli en cas d'erreur
ContentSimple:
type: object
required:
- role
- parts
properties:
role:
type: string
description: Rôle du contenu
enum:
- user
example: user
parts:
type: array
description: Liste des parties du contenu (texte brut)
items:
$ref: '#/components/schemas/TextPart'
minItems: 1
Candidate:
type: object
properties:
content:
$ref: '#/components/schemas/ContentResponse'
finishReason:
type: string
description: Raison de fin
enum:
- STOP
- MAX_TOKENS
- SAFETY
- RECITATION
- OTHER
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 en entrée
example: 4
candidatesTokenCount:
type: integer
description: Nombre de tokens en 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'
TextPart:
type: object
required:
- text
properties:
text:
type: string
description: Contenu texte
example: |-
Hello! I'm glad to introduce myself.
I'm a large language model trained and developed by Google...
ContentResponse:
type: object
properties:
role:
type: string
description: Rôle de réponse
enum:
- model
example: model
parts:
type: array
description: Parties du contenu de la réponse
items:
$ref: '#/components/schemas/TextPart'
TokenDetail:
type: object
description: Détails des tokens (par modalité)
properties:
modality:
type: string
description: Type de modalité de contenu
enum:
- TEXT
- IMAGE
- AUDIO
- VIDEO
example: TEXT
tokenCount:
type: integer
description: Nombre de tokens pour cette modalité
example: 4
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
```
````