gemini-3.1-flash-image API d’images IA
gemini-3.1-flash-image (Nano Banana 2): 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.
Sortie
Aperçu
Généré avec Image 2
Résumé de la requête
- Point de terminaison
- POST /v1beta/models/gemini-3.1-flash-image:generateContent
- ID du modèle
- gemini-3.1-flash-image
- Format
- 16:9
- Résolution
- 1K
Aperçu uniquement. Connectez-vous pour envoyer cette requête à Flatkey.
{
"model": "gemini-3.1-flash-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark.\n\nComposition 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.\n\nAvoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above."
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
}Performances de l’API
gemini-3.1-flash-image Fiabilité et disponibilité de l’API
La télémétrie des requêtes Flatkey pour gemini-3.1-flash-image apparaîtra ici lorsque le trafic de production sera suffisant.
Activité de l’API
gemini-3.1-flash-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.1-flash-image sur la dernière période de reporting.
gemini-3.1-flash-image tarifs
gemini-3.1-flash-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.
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.
- Type de modèle
- Texte vers image
- API
- /v1beta/models/gemini-3.1-flash-image:generateContent
- Base de facturation
- 1M tokens
- Sorties
- 1
gemini-3.1-flash-image générateur d’images IA et API: capacités principales
La route gemini-3.1-flash-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.1-flash-image Comparaison API : capacités et accès
Comparez les faits du catalogue pour gemini-3.1-flash-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édente | gemini-3.1-flash-image |
|---|---|---|
| Fournisseur | Non vérifié dans cet instantané du catalogue | |
| Modalités | Non vérifié dans cet instantané du catalogue | texte · image |
| Contexte | Non vérifié dans cet instantané du catalogue | La fenêtre de contexte n’est pas indiquée dans le catalogue |
| Point de terminaison | Non vérifié dans cet instantané du catalogue | /v1beta/models/gemini-3.1-flash-image:generateContent |
| Facturation | Non vérifié dans cet instantané du catalogue | $0.5/$3 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.
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.06
- 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.
Texte vers image
Générez une image depuis un texte.
- ID du modèle
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Image guidée par référence
Utilisez des références pour modifier ou varier une image.
- ID du modèle
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Compatibilité des paramètres
Valeurs issues de la même configuration que le Playground.
aspect_ratioFormat1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9
Par défaut: 1:1image_sizeTaille1K · 2K · 4K
Par défaut: 1KimageLimite de références4 fichiers
Endpoint: /v1beta/models/gemini-3.1-flash-image:generateContentDu 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
Valider modèle, prompt, références et sortie.
- 2
Envoyer la requête image.
- 3
Lire le résultat ou la tâche asynchrone.
- 4
Stocker le fichier et ses métadonnées.
Contrôles de production
Bloquez les valeurs ou références non prises en charge.
Gérez séparément clés, solde, limites et groupe.
Identifiez le prompt ou le média à remplacer.
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.1-flash-image pour génération d’images
Commencez par un prompt gemini-3.1-flash-image pour génération d’images, puis ajustez les champs de requête affichés dans le playground.
Généré avec Image 2
Scene: A 16:9 futuristic game loadout frame shows a helmeted rider beside a black-and-orange motorcycle in a rainy industrial hangar. Blue-and-orange interface controls and a circular part-selection panel sit around the vehicle. Keep the rider, motorcycle geometry, wet floor reflections, lighting direction, and selected-part position fixed for a clean equipment swap. 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.
Scene: A poolside sports broadcast catches a swimmer in a blue cap during freestyle, with one arm entering the water and a sharp splash across the lane. Use a low pool-deck camera, blue water, lane markings, and abstract blue lower-third graphics without readable text. Keep swimmer direction, splash shape, and framing consistent; no real athletes, teams, 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.
Généré avec Image 2
Scene: A metallic wireless-earbud charging case floats open above a glossy black surface while the two matching earbuds hover above their slots. Purple and cyan rim lights define the rounded metal, black interior, reflections, and empty dark background. Preserve the case, earbuds, hinge, highlights, and three-quarter camera angle. 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.
Généré avec Image 2
Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. 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.
Généré avec Image 2
Scene: In a wet green park, a man in a coral-red raincoat and yellow boots struggles with an inverted rainbow umbrella in a gust of wind. His arms brace against the bent canopy while rain streaks through the trees and puddles reflect the bright colors. Keep the umbrella shape, body pose, wind direction, and safe footing clear; no injury, readable text, logos, 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.
Généré avec Image 2
Scene: A softly faded historical dock scene shows several workers repairing a large wooden boat at a riverside boatyard. Timber ribs, scaffolding, hand tools, smaller boats, and weathered work clothes fill the wide documentary frame. Restore the wood grain, riverbank structures, faces, and natural color aging without modern objects, readable signs, 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.
Pourquoi l’API gemini-3.1-flash-image
Pourquoi utiliser gemini-3.1-flash-image via Flatkey ?
Utilisez une seule passerelle pour gemini-3.1-flash-image, les contrôles du compte et le reste du catalogue de modèles.
gemini-3.1-flash-image dans une seule API
Gardez l’ID du modèle et l’endpoint gemini-3.1-flash-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.1-flash-image avant l’envoi, puis confirmez l’estimation finale dans votre compte.
Passage pratique au modèle
Testez un prompt gemini-3.1-flash-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.1-flash-image sans modifier le flux de travail de votre application côté fournisseur.
API
gemini-3.1-flash-image API
Quatre méthodes avec la même clé et le même catalogue. Choisissez-en une pour voir un exemple exécutable.
curl https://router.flatkey.ai/v1beta/models/gemini-3.1-flash-image:generateContent \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"gemini-3.1-flash-image","contents":[{"role":"user","parts":[{"text":"Créez avec gemini-3.1-flash-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"}}}'
Questions fréquentes
gemini-3.1-flash-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.1-flash-image.




