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.
Sortie
Aperçu
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
- 16:9
- Résolution
- 1K
Aperçu uniquement. Connectez-vous pour envoyer cette requête à Flatkey.
{
"model": "gemini-3-pro-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "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.\n\nComposition 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.\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-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.
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.
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.
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-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édente | gemini-3-pro-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-pro-image:generateContent |
| Facturation | Non 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.
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.
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
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_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-pro-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-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.
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.
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.
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.
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.
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.
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.
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.
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"}}}'
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.




