Différences de paramètres et de protocoles de Gemini

Découvrez les différences de paramètres et l’utilisation de Gemini avec les protocoles compatibles.

Réglez pensée, outils et cache Gemini selon cette page. Structures : Generate Content, Stream Generate Content, Chat Completions ; règles natives communes en mode normal et diffusé.

Modèles concernés

Modèle	Points d’utilisation
gemini-4-argon	Niveaux natifs `LOW/MEDIUM/HIGH`, défaut `MEDIUM` ; cache implicite seulement, sortie longue par continuation
gemini-3.8-flash	Même choix de trois niveaux, défaut `MEDIUM`, pas de `MINIMAL` natif ; cache implicite et explicite
gemini-3.7-flash	Trois niveaux, défaut `MEDIUM`, pas de `MINIMAL` natif. Google Developer API l’a déprécié au profit de 3.8 ; décision propre au service Google, sans retrait ni remplacement automatique sur la plateforme

Différences Generate Content

Champ	Différence
`thinkingConfig.thinkingLevel`	Aucun des trois ne désactive avec `MINIMAL` ou ancien budget nul ; réduire avec `LOW`, pas la méthode Gemini 2.5
`thinkingConfig.thinkingBudget`	Nouvelles intégrations : `thinkingLevel` ; les deux champs sont incompatibles. Developer API d’Argon transforme un ancien budget seul vers le niveau proche avec avertissement
`temperature/topP/topK`	Ancien échantillonnage ignoré ; omettre ces champs, sans effet sur les réglages
`candidateCount`	Gemini 3 et suivants ne prennent pas ce réglage en charge ; retirer
`frequencyPenalty/presencePenalty`	Le guide Google Cloud 3.7 Flash indique une erreur, contrairement à l’échantillonnage ignoré ci-dessus
`thinkingConfig.includeThoughts`	`parts[].thought` distingue résumé de pensée et réponse ; le résumé n’est pas la pensée originale et ne remplace pas les signatures
`parts[].thoughtSignature`	Conserver tous les Parts inchangés ; signatures obligatoires dans l’historique d’outils. Ne pas fusionner blocs signés et non signés
`functionCall/functionResponse`	Faire correspondre `id`, `name` de chaque résultat à l’appel réel, sans omission ni confusion des résultats parallèles
Préremplissage model	Ne pas terminer par un message model inachevé ; 3.8 exige aussi du texte non vide au dernier tour user
`maxOutputTokens`	Inclut pensée et réponse. REST direct Argon : `32768` par étape non diffusée, `65536` par étape diffusée ; au-delà, continuation nécessaire, pas simple augmentation pour une seule réponse
`continuationToken`	Ici seul Argon continue les sorties longues : avec `CONTINUATION`, garder entrée, outils et budget total et envoyer le dernier jeton. Après `MAX_TOKENS`, augmenter au-delà des tokens déjà utilisés. Ne pas ajouter la sortie intermédiaire à `contents`

Différences Chat Completions

Ces règles décrivent la compatibilité Chat officielle Google, pas nécessairement la conversion de tous les canaux de plateforme.

Champ	Différence
`reasoning_effort`	Ces modèles utilisent `low/medium/high`, défaut `medium` ; Argon accepte aussi `minimal`, converti en `low`
`extra_body.google.thinking_config`	Transmet les réglages Gemini, dont `thinking_level`, `include_thoughts` ; incompatible avec `reasoning_effort`
`tool_calls[].extra_content`	Conserver `google.thought_signature` avec tout l’historique d’outils ; nom et arguments seuls perdent la signature
`response_format`	Sortie JSON officielle disponible avec le sous-ensemble Schema Gemini, pas tous les comportements OpenAI. Champs natifs dans Generate Content Reference
Continuation des sorties longues	La compatibilité Chat officielle Google ne permet pas la continuation longue ; utiliser Generate Content ou Stream Generate Content natif

Différences de cache

Champ	Différence
Cache implicite	Actif par défaut sans commutateur ; Argon et 3.8 Flash : préfixe minimal `4096` tokens, identique, sans garantie de hit
`cachedContent`	Argon refuse création et référence de cache explicite ; 3.8 Flash les accepte, comme 3.7 Flash dans Google Cloud
Références de cache Chat	La compatibilité Google référence le cache natif via `extra_body.google.cached_content`, pas `prompt_cache_options` OpenAI ; passer par Chat n’ajoute pas ce support à Argon
Utilisation du cache	Vérifier `usageMetadata.cachedContentTokenCount` natif réellement renvoyé ; réglage actif seul insuffisant

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`inlineData` natif	Données Base64 avec le bon `mimeType`
Fichier	`fileData` natif	Images, audio, vidéo, PDF : URI lisible par le service, pas chemin local ; références Files du service correspondant
Image	Chat `image_url`	URL d’image acceptée ou Base64 Data URL ; pas la structure native Parts
Audio	Chat `input_audio`	Exemple officiel : audio Base64 avec `format`, pas un réglage de génération audio

Champ	Différence
`mediaResolution`	Précision de traitement du média d’entrée ; structures distinctes par requête ou Part, réglage individuel prioritaire. Pas la résolution d’image de sortie
`responseModalities`	Les trois produisent seulement du texte, avec `TEXT`. `IMAGE/AUDIO`, `imageConfig`, `speechConfig` du Schema général ne servent pas à générer images ou voix ici

Exemples d’appel

Remplacez MODEL_ID par l’ID complet. Deux exemples avec effort moyen et budget explicite, sans continuation automatique.

curl 'https://api.agtcloud.cn/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "contents": [{"role": "user", "parts": [{"text": "Expliquez en trois points comment diagnostiquer un délai d’attente API"}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "MEDIUM"},
      "maxOutputTokens": 32768
    }
  }'