Format natif Gemini

Pour les applications développées sur la base du SDK Google GenAI, 4ALL API fournit une compatibilité avec le protocole natif Gemini :

POST https://api.4allapi.com/v1beta/models/{model}:generateContent
POST https://api.4allapi.com/v1beta/models/{model}:streamGenerateContent

Exemple de requête

curl "https://api.4allapi.com/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $AIPROXY_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "用三句话介绍黑洞"}]
    }]
  }'

Points clés :

L’authentification utilise l’en-tête x-goog-api-key (compatible aussi avec le paramètre de requête ?key=) ;
L’entrée multimodale est transmise via le tableau parts, par exemple inline_data (images base64), etc. ;
Le mode flux utilise :streamGenerateContent et renvoie des blocs JSON incrémentaux ;
Les paramètres de génération se placent dans generationConfig (temperature, maxOutputTokens, etc.).

Faut-il utiliser le format natif ou la compatibilité OpenAI ?

Cas	Recommandation
Nouveau projet / bascule entre plusieurs modèles	Utiliser l’API compatible OpenAI, il suffit de changer `model`
Code existant basé sur le SDK Google	Utiliser le protocole natif, il suffit de modifier `base_url`
Besoin de champs spécifiques à Gemini (comme les réglages de safety)	Utiliser le protocole natif