curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.5-flash:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.5-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "error": {
    "code": 400,
    "message": "Paramètres de requête invalides",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Quota insuffisant",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "Corps de la requête trop volumineux",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "error": {
    "code": 429,
    "message": "Limite de débit dépassée",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Erreur interne du serveur",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporairement indisponible",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Google Native API Format

Gemini 3.5 Flash - API Native - Référence Complète

Appel du modèle gemini-3.5-flash au format Google Native API
Peut utiliser le mode de traitement synchrone, retourne le contenu de la conversation en temps réel
Conversation en texte brut : Dialogue contextuel à un ou plusieurs tours, voir les exemples simple_text et multi_turn dans les échantillons de code
Entrée multimodale : Prend en charge l’entrée mixte texte + image/audio/vidéo, voir les exemples audio_analysis, image_understanding et multi_file dans les échantillons de code
Réglage des paramètres : Contrôler la qualité de génération via generationConfig
Streaming : Remplacez generateContent par streamGenerateContent dans l’URL

POST

v1beta

models

gemini-3.5-flash:generateContent

curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.5-flash:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.5-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "error": {
    "code": 400,
    "message": "Paramètres de requête invalides",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Quota insuffisant",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "Corps de la requête trop volumineux",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "error": {
    "code": 429,
    "message": "Limite de débit dépassée",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Erreur interne du serveur",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporairement indisponible",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

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.

Autorisations

Authorization

string

header

requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

contents

object[]

requis

List of conversation contents, supports multi-turn dialogue and multimodal input

Minimum array length: 1

Show child attributes

generationConfig

object

Generation configuration parameters (optional)

Show child attributes

systemInstruction

object

System instruction (optional), mainly text content

Show child attributes

tools

object[]

List of tools the model can call, such as function calling or code execution

toolConfig

object

Tool calling configuration (optional)

safetySettings

object[]

Safety settings list (optional)

cachedContent

string

Cached content name, in the form cachedContents/{cachedContent}

Réponse

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)

Réponse synchrone
Réponse en flux

candidates

object[]

List of candidate responses

Show child attributes

promptFeedback

object

Show child attributes

usageMetadata

object

Statistiques d'utilisation

Show child attributes

modelVersion

string

Model version

Exemple:

"gemini-3.5-flash"

responseId

string

Response ID

Exemple:

"l-LoaPu0BPmo1dkP6ZPHiQc"

Gemini 3.5 Flash - API Native - Démarrage Rapide Gemini 3.1 Pro - OpenAI SDK - Démarrage Rapide

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Gemini 3.5 Flash - API Native - Référence Complète

Autorisations

Corps

Réponse