gemini-2.5-flash-image API

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

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

Paramètres : size=2Kratio=16:9

Prompt : The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, film grain, no text.

Requête qui a produit cet échantillon

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, film grain, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

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-2.5-flash-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 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	Non	1K / 2K / 4K

Limites de réponse et d’entrée

Gemini 2.5 Flash Image prend en charge 1K, 2K et 4K avec 1:1, 4:3, 3:4, 16:9 et 9:16. La documentation officielle ne publie pas de plafond de nombre d’images de référence, donc la passerelle n’ajoute aucun plafond local.

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-2.5-flash-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-2.5-flash-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 la facturation par appel. 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.