gemini-3.1-flash-lite-image API

Utilisez l’ID de modèle exact gemini-3.1-flash-lite-image. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiegemini-3.1-flash-lite-imagePOST /v1beta/models/gemini-3.1-flash-lite-image:generateContent

Paramètres : ratio=16:9

Prompt : A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text.

Requête qui a produit cet échantillon

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev. Le point d’entrée de la passerelle est POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Générer une image

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Demander des notes

Les modèles d’images Gemini utilisent contents et generationConfig natifs ; les modifications envoient l’instruction texte et inline_data dans le même parts[].

Paramètres de requête

Les modèles d’images Gemini utilisent Gemini natif generateContent. Mettez le texte et les images de référence dans le même contents[].parts[] ; les images utilisent inline_data. N’envoyez pas ces modèles vers /v1/images/generations, /v1/images/edits ou OpenAI /v1/responses. L’énumération imageSize est spécifique au modèle et est illustrée ci-dessous.

Champ	Obligatoire	Remarques
contents[].parts[].text	Oui	Invite textuelle ou instruction de modification
contents[].parts[].inline_data	Non	Données d’image Base64 et type MIME
contents[].parts[].inline_data.mime_type	Non	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Non	Contenu de l’image de référence codée en base64
generationConfig.responseModalities	Oui	["IMAGE"] ou ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Non	1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
generationConfig.imageConfig.imageSize	Non	1K

Limites de réponse et d’entrée

Lite prend uniquement en charge 1K avec 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 et 21:9. La documentation officielle ne publie pas de plafond de nombre d’images de référence, donc la passerelle n’ajoute aucun plafond local et renvoie l’erreur de service lorsque la limite de service est dépassée.

Exemple d’édition d’image

Placez l’instruction d’édition et l’image de référence dans le même contents[].parts[]. inline_data.data est le contenu de l’image Base64 ; n’envoyez pas de modèles d’image Gemini aux points de terminaison OpenAI Images ou Responses.

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Forme de réponse

Lire candidates[].content.parts[] ; ne présumez pas que chaque partie est une image car la réponse peut contenir ensemble des parties de texte et d’image.

Champ	Remarques
candidates[].content.parts[].inline_data	Type MIME de l’image générée et données Base64
candidates[].content.parts[].text	Légende de texte renvoyée lorsque TEXT a été demandé
candidates[].finishReason	Raison d’achèvement ou de sécurité
usageMetadata	Utilisation du jeton d’entrée/sortie lorsqu’il est renvoyé par le service

Modelflare préserve la forme de réponse native Gemini pour gemini-3.1-flash-lite-image et conserve les parties d’image utilisables.

Erreurs et tâches ayant échoué

Les erreurs de champ, les limites de taille/rapport et les refus de sécurité de la requête Gemini native restent des réponses d’erreur compatibles avec Gemini. La passerelle ne les réécrit pas en tant que réponses OpenAI Images.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise une facturation basée sur des jetons. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.