gemini-3-pro-image API d’images IA

gemini-3-pro-image (Nano Banana Pro): Générez des images, retouchez des références et affinez vos créations avec Flatkey. L’exemple utilise contents/parts de Gemini, pas un corps de requête Images API interchangeable.

Texte vers imageImage guidée par référence
Entrée /M
$2/ 1 M tokens$2/ 1 M tokens
Cache /M
$0.2/ 1 M tokens$0.2/ 1 M tokens
Sortie /M
$12/ 1 M tokens$12/ 1 M tokens
Fournisseur
Google
Configuration du générateur · Playground (modifiez avant l’inscription)

Entrée

InstructionVoir plus865 / 10000
Prompts rapides
Images de référence
Commencer la génération

Sortie

Aperçu
Aperçu image

Généré avec Image 2

Résumé de la requête

Point de terminaison
POST /v1beta/models/gemini-3-pro-image:generateContent
ID du modèle
gemini-3-pro-image
Format
1:1
Résolution
1K

Aperçu uniquement. Connectez-vous pour envoyer cette requête à Flatkey.

Aperçu de la requête
{
  "model": "gemini-3-pro-image",
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Creative direction: Create a vertical museum-catalog infographic dissecting a Ming-dynasty hanfu. Place a central woman in a pale robe, exploded garment components and construction views on the left, fabric, weave, and pattern swatches on the right, and a step-by-step dressing sequence along the bottom. Use a restrained cream, navy, muted red, and ink palette with precise Chinese annotation hierarchy and generous archival margins.\n\nComposition, material and finish: Use a strict museum-plate grid with aligned callout leaders and consistent scale within each garment view. Distinguish weave, embroidery and seam construction without turning fabric into metal. Keep the same robe and wearer across every detail and dressing step. Preserve negative space between diagrams and Chinese labels; avoid invented historical claims, mismatched fastenings and watermarks."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

Performances de l’API

gemini-3-pro-image Fiabilité et disponibilité de l’API

La télémétrie des requêtes Flatkey pour gemini-3-pro-image apparaîtra ici lorsque le trafic de production sera suffisant.

Disponibilité moyenne du fournisseur
80.7%
30 derniers jours
Latence
2.79s
30 derniers jours
Requêtes
88
Fenêtre de 30 jours
Tendance des inférences réussies

Activité de l’API

gemini-3-pro-image Utilisation et activité des requêtes API

Suivez le volume de requêtes et l’activité d’inférence réussie de gemini-3-pro-image sur la dernière période de reporting.

Requêtes
88
Fenêtre de 30 jours
Latence
2.79s
30 derniers jours
Disponibilité
80.7%
30 derniers jours
Tendance des inférences réussiesActivité

gemini-3-pro-image tarifs

gemini-3-pro-image Tarifs et facturation de l’API

Les cartes affichent les tarifs actuels des tokens d’entrée et de sortie Flatkey. Un tarif par token n’est pas un prix fixe par image : réglages, références et sortie influencent l’usage. Les tarifs et quotas gratuits directs Google ne s’appliquent pas automatiquement.

Prix Flatkey

Entrée /M

Modèle du catalogue en direct
$2/ 1 M tokens$2/ 1 M tokens
Entrée /M
$2/ 1 M tokens$2/ 1 M tokens
Cache /M
$0.2/ 1 M tokens$0.2/ 1 M tokens
Sortie /M
$12/ 1 M tokens$12/ 1 M tokens
Entrée image /M
$0.12/ 1 M tokens$0.12/ 1 M tokens
Essayer un prompt
Solde partagé

Ajouter des crédits

Ajouter des crédits

Utilisez le même solde et la même clé API Flatkey pour les modèles image, vidéo, audio et texte.

Catalogue de modèles
Type de modèle
Texte vers image
API
/v1beta/models/gemini-3-pro-image:generateContent
Base de facturation
1M tokens
Sorties
1

gemini-3-pro-image générateur d’images IA et API: capacités principales

La route gemini-3-pro-image de Google prend en charge texte · image. Catégories du catalogue: Marketing.

Texte vers image

Décrivez sujet, composition, lumière et texte. Placez les réglages de sortie dans les champs de requête, pas uniquement dans le prompt.

Image de référence

Ajoutez des références et précisez les éléments à conserver ou modifier. Respectez les limites de la matrice de paramètres.

Sorties

Choisissez uniquement les formats et tailles proposés par le Playground. Flash, Flash Lite et Pro n’ont pas les mêmes limites.

API

Conservez l’identifiant exact et la structure contents/parts indiquée. Testez une petite requête avant un traitement par lots.

Comparer

gemini-3-pro-image Comparaison API : capacités et accès

Comparez les faits du catalogue pour gemini-3-pro-image à la référence de la génération précédente avant de modifier votre intégration.

CapacitéGénération précédentegemini-3-pro-image
FournisseurNon vérifié dans cet instantané du catalogueGoogle
ModalitésNon vérifié dans cet instantané du cataloguetexte · image
ContexteNon vérifié dans cet instantané du catalogueLa fenêtre de contexte n’est pas indiquée dans le catalogue
Point de terminaisonNon vérifié dans cet instantané du catalogue/v1beta/models/gemini-3-pro-image:generateContent
FacturationNon vérifié dans cet instantané du catalogue$2/$12 per 1M tokens

Choisir la bonne requête avant l’intégration

Vérifiez les workflows, le coût actuel et le contrat exact des paramètres Flatkey.

Estimation du coût en direct

Calculée avec les réglages actuels et le tarif du catalogue lorsqu’un prix unitaire fixe existe.

Configuration actuelle
1×
Tarif en direct
$0.12
Requête estimée
Tarification à l’usage

Le montant final dépend de la requête et du groupe de compte ; les tarifs par jetons ou paliers ne donnent pas un montant fixe.

Workflows et Model ID

Utilisez uniquement les workflows disponibles. Flatkey conserve un ID public et le corps choisit l’entrée.

Disponible

Texte vers image

Générez une image depuis un texte.

ID du modèle
gemini-3-pro-image
Endpoint
/v1beta/models/gemini-3-pro-image:generateContent
Disponible

Image guidée par référence

Utilisez des références pour modifier ou varier une image.

ID du modèle
gemini-3-pro-image
Endpoint
/v1beta/models/gemini-3-pro-image:generateContent

Compatibilité des paramètres

Valeurs issues de la même configuration que le Playground.

aspect_ratioFormat
Valeurs

1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9

Par défaut: 1:1
image_sizeTaille
Valeurs

1K · 2K · 4K

Par défaut: 1K
imageLimite de références
Valeurs

4 fichiers

Endpoint: /v1beta/models/gemini-3-pro-image:generateContent

Du premier test à la production

Gardez le même contrat dans le Playground et l’API et gérez validation, solde, état et résultat.

Cycle de la requête

  1. 1

    Valider modèle, prompt, références et sortie.

  2. 2

    Envoyer la requête image.

  3. 3

    Lire le résultat ou la tâche asynchrone.

  4. 4

    Stocker le fichier et ses métadonnées.

Contrôles de production

Validation

Bloquez les valeurs ou références non prises en charge.

Authentification et solde

Gérez séparément clés, solde, limites et groupe.

Entrée refusée

Identifiez le prompt ou le média à remplacer.

Échec ou délai

Conservez le task ID, limitez les reprises et ne marquez pas un délai comme succès.

Bibliothèque de prompts

Exemples de prompts gemini-3-pro-image pour génération d’images

Commencez par un prompt gemini-3-pro-image pour génération d’images, puis ajustez les champs de requête affichés dans le playground.

Interaction UI de jeu et changement d’équipement
Interaction UI de jeu et changement d’équipement

Généré avec Image 2

Scene: A 16:9 underwater game loadout screen on a sea floor. An armored diver stands on a circular pedestal holding a glowing cyan sword, with submerged ruins behind and a weapon-swap panel on the right. Lock the diver silhouette, sword, aquatic lighting, pedestal, and interface hierarchy for an exact equipment-switch frame. No readable words, logos, invented stats, or watermark. Composition and rendering: Deliver one 16:9 game-interface keyframe. Separate the character, held equipment and HUD into clear depth layers; keep slot spacing and icon scale consistent, with the selected item visually dominant. Preserve the scene-specific game art style. Let material edges catch the existing light without letting interface glow obscure the silhouette. Keep all equipment fully inside the frame. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire
Simulation de retransmission sportive télévisée
Simulation de retransmission sportive télévisée

Généré avec Image 2

Scene: A televised basketball frame shows a red-uniform player taking a jump shot while a white-uniform defender contests it in an indoor arena. Include the hoop, overhead lights, crowd blur, and abstract red-and-gray lower-third panels without readable text. Keep the broadcast angle, ball arc, uniforms, and player spacing coherent; no real teams, athletes, logos, or watermark. Composition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire
TVC de marque et vitrine e-commerce
TVC de marque et vitrine e-commerce

Généré avec Image 2

Scene: A clear glass dropper bottle filled with pale gold serum stands on a white stone block in a warm cream room. Soft sunlight and large leaf shadows fall across the wall and the liquid, glass, metal collar, and surface catch subtle reflections. Preserve the bottle proportions and generous blank space; no readable branding, extra products, hands, or watermark. Composition and rendering: Deliver one 16:9 commercial product still. Keep the complete product silhouette inside generous crop-safe margins. Resolve edges, seams and material transitions precisely; shape highlights to describe volume without clipping bright surfaces or crushing dark details. Align reflections with the object and light source. Retain the stated camera angle and existing negative space; add no decorative props. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire
Personnage cinéma et direction de storyboard
Personnage cinéma et direction de storyboard

Généré avec Image 2

Scene: At a rain-wet historic train platform, a young traveler in a dark cap and coat holds a brown suitcase while a steam train waits under a long canopy. Warm lamps recede into the blue night and reflect on the platform. Hold the traveler profile, suitcase, train direction, and wide composition for a continuous storyboard. No readable signs, logos, or watermark. Composition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire
Gag comique et narration physique
Gag comique et narration physique

Généré avec Image 2

Scene: On a small theater stage, a startled magician in black pulls a long rainbow cloth from a tall black trunk wrapped in more cloth. The audience is dim behind him, with red curtains and colored spotlights. Freeze the harmless reveal at the moment the fabric stretches between hand and trunk; preserve object weight, pose, and stage spacing. No readable words, logos, injury, or watermark. Composition and rendering: Deliver one 16:9 physical-comedy still at the described instant. Make the cause of the gag readable through body balance, grip and object spacing. Separate the reaction from the airborne props; retain believable gravity and contact points. Keep the face and important props sharp, with only restrained directional blur on fast edges. Preserve the stated lighting and room or stage layout. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire
Restauration photo historique et résurrection documentaire
Restauration photo historique et résurrection documentaire

Généré avec Image 2

Scene: A sepia archival photograph shows four workers weaving cloth on wooden looms inside a rustic workshop, with yarn baskets and bright hillside scenery through the windows. Restore the paper texture, faces without sharpening them into modern portraits, loom construction, period clothing, and gentle film wear. No modern objects, readable signage, logos, captions, or watermark. Composition and restoration: Deliver one 16:9 archival-style still. Preserve the original framing, period-specific construction and restrained tonal range; retain monochrome, sepia or faded color as described. Recover modest detail in faces, clothing and architecture without synthetic sharpening. Keep fine grain and authentic aging consistent across the frame; repair damage without replacing historical features. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.

Créer similaire

Pourquoi l’API gemini-3-pro-image

Pourquoi utiliser gemini-3-pro-image via Flatkey ?

Utilisez une seule passerelle pour gemini-3-pro-image, les contrôles du compte et le reste du catalogue de modèles.

gemini-3-pro-image dans une seule API

Gardez l’ID du modèle et l’endpoint gemini-3-pro-image explicites avec la même clé Flatkey que pour les autres charges.

Tarifs du catalogue en direct

Consultez les dimensions de facturation actuelles de gemini-3-pro-image avant l’envoi, puis confirmez l’estimation finale dans votre compte.

Passage pratique au modèle

Testez un prompt gemini-3-pro-image dans le playground public et réutilisez les mêmes réglages dans une intégration authentifiée.

Contrôles d’usage et de routage

Centralisez clés, quotas et routage pour gemini-3-pro-image sans modifier le flux de travail de votre application côté fournisseur.

API

gemini-3-pro-image API

Quatre méthodes avec la même clé et le même catalogue. Choisissez-en une pour voir un exemple exécutable.

Appelez tout modèle avec une API compatible OpenAI. Copiez un exemple prêt à exécuter pour votre modèle et langage.
Utilisez le SDK OpenAI que vous connaissez déjà — avec Flatkey comme passerelle.
Générez des images et des vidéos depuis votre terminal. Laissez votre assistant IA piloter le flux de travail.
Connectez votre agent de code en une seule commande, puis utilisez Flatkey depuis vos projets existants.
curl https://router.flatkey.ai/v1beta/models/gemini-3-pro-image:generateContent \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{"model":"gemini-3-pro-image","contents":[{"role":"user","parts":[{"text":"Créez avec gemini-3-pro-image une image produit de haute qualité : composition nette, lumière précise, sujet mis en valeur et détails réalistes."}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}}}'
Documentation

Questions fréquentes

gemini-3-pro-image API
questions sur les tarifs, fonctions et l’usage

Réponses sur les tarifs, capacités, endpoints et limites du catalogue de gemini-3-pro-image.

À quoi sert gemini-3-pro-image ?
gemini-3-pro-image (Nano Banana Pro): Générez des images, retouchez des références et affinez vos créations avec Flatkey. L’exemple utilise contents/parts de Gemini, pas un corps de requête Images API interchangeable.
Comment gemini-3-pro-image est-il facturé ?
Entrée /M: $2; Cache /M: $0.2; Sortie /M: $12; Entrée image /M: $0.12. Les cartes affichent les tarifs actuels des tokens d’entrée et de sortie Flatkey. Un tarif par token n’est pas un prix fixe par image : réglages, références et sortie influencent l’usage. Les tarifs et quotas gratuits directs Google ne s’appliquent pas automatiquement.
Quel endpoint API appelle gemini-3-pro-image ?
POST /v1beta/models/gemini-3-pro-image:generateContent · gemini-3-pro-image
Flatkey expose-t-il toutes les fonctions documentées par Google ?
Non. Les spécifications Google et le contrat de la route Flatkey ont des périmètres différents. Utilisez les champs pris en charge ici ; le nom du modèle ne garantit ni recherche, ni outils, ni tous les types d’entrée officiels.