gemini-2.5-flash-image AI Image API
Google gemini-2.5-flash-image for image generation; Flatkey routes this model through /v1/images/generations. $0.24/$2 per 1M tokens
Output
Preview
Generated with Image 2
Request summary
- Endpoint
- POST /v1beta/models/gemini-2.5-flash-image:generateContent
- Model ID
- gemini-2.5-flash-image
- Aspect ratio
- 16:9
- Resolution
- 1K
Preview only. Sign in to submit this request to Flatkey.
{
"model": "gemini-2.5-flash-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "Scene: A lone astronaut stands inside a glass biodome on a red desert planet, seen from behind among glowing bioluminescent plants. A hazy red landscape and distant mountains show through the curved glass. Hold the character silhouette, plant positions, cool interior light, and wide screen direction for storyboard continuity. No readable text, 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"
}
}
}gemini-2.5-flash-image API performance
gemini-2.5-flash-image API reliability and uptime
Live Flatkey request telemetry for gemini-2.5-flash-image appears here when enough production traffic is available.
gemini-2.5-flash-image API activity
gemini-2.5-flash-image API usage and request activity
Track request volume and successful inference activity for gemini-2.5-flash-image over the latest reporting window.
gemini-2.5-flash-image pricing
gemini-2.5-flash-image API pricing and billing
Prices below are calculated from Flatkey pricing data for this model and the visible groups currently returned by our pricing API.
Add credits
Use the same Flatkey balance and API key across image, video, audio, and text models.
- Model Type
- Text to Image
- API
- /v1beta/models/gemini-2.5-flash-image:generateContent
- Billing basis
- 1M tokens
- Outputs
- 1
gemini-2.5-flash-image image generation: core capabilities
Google's gemini-2.5-flash-image route supports text · image. Catalog categories: Marketing.
gemini-2.5-flash-image visual creation
Turn a written brief into product, editorial, or campaign imagery through /v1/images/generations.
gemini-2.5-flash-image reference-led editing
Use an existing image as creative direction for revisions and consistent visual variants when the route accepts references.
gemini-2.5-flash-image channel-ready variants
Adapt one concept into the image compositions your storefront, campaign, or content pipeline needs.
gemini-2.5-flash-image creative production workflow
Move an approved visual from prompt exploration into a repeatable Flatkey generation workflow.
Compare
gemini-2.5-flash-image API comparison: capabilities and access
Compare the catalog facts for gemini-2.5-flash-image with the previous-generation baseline before changing your integration.
| Capability | Previous generation | gemini-2.5-flash-image |
|---|---|---|
| Provider | Not verified in this catalog snapshot | |
| Modalities | Not verified in this catalog snapshot | text · image |
| Context | Not verified in this catalog snapshot | Context window not listed in the catalog |
| Endpoint | Not verified in this catalog snapshot | /v1/images/generations |
| Billing | Not verified in this catalog snapshot | $0.24/$2 per 1M tokens |
Choose the right request before you integrate
Review the supported workflows, live cost for the current setup, and the exact parameter contract used by Flatkey.
Calculated from the current Playground settings and the live catalog rate when a fixed unit price is available.
- Current setup
- 1×
- Live rate
- $0.024
- Estimated request
- Variable usage pricing
The final charge follows the submitted request and your account group. Token-priced or tiered requests cannot be reduced to one fixed estimate.
Workflows and Model ID
Use only the workflows marked available. Flatkey keeps one public model ID while the request body selects the input workflow.
Text to Image
Generate a new image from a text prompt and output controls.
- Model ID
gemini-2.5-flash-image- Endpoint
/v1beta/models/gemini-2.5-flash-image:generateContent
Reference-guided Image
Use reference images for edits, variations, or identity and composition guidance.
- Model ID
gemini-2.5-flash-image- Endpoint
/v1beta/models/gemini-2.5-flash-image:generateContent
Parameter compatibility
These values come from the same model configuration used by the Playground and request preview.
aspect_ratioAspect ratio1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9
Default: 1:1imageReference limit4 files
Endpoint: /v1beta/models/gemini-2.5-flash-image:generateContentFrom first test to production
Use the same request contract in the Playground and API, then handle validation, balance, task state, and output retrieval explicitly.
Request lifecycle
- 1
Validate the model, prompt, references, and output settings.
- 2
POST the image request with the documented fields.
- 3
Read the generated output or asynchronous task result returned by the route.
- 4
Store the generated file and request metadata in your own workflow.
Production checks
Reject unsupported sizes, durations, ratios, formats, or reference counts before submitting.
Handle invalid keys, insufficient balance, rate limits, and account-group pricing separately.
Surface the rejected prompt or asset clearly so the user can replace only the failing input.
Keep the task ID, use bounded retries, and never treat a timeout as a successful generation.
Prompt library
gemini-2.5-flash-image image generation prompt examples
Start with a gemini-2.5-flash-image prompt for product and ecommerce images, then adjust the request fields shown in the playground.
Generated with Image 2
Scene: A 16:9 fantasy game loadout screen in mossy forest ruins. A hooded green archer stands centered with a bow; a circular equipment wheel sits around the character and alternate equipment silhouettes occupy the right panel. Keep the green-and-gold HUD, pose, ruins, and prop geometry fixed 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.
Generated with Image 2
Scene: A live basketball broadcast frame catches a blue-uniform player airborne for a dunk in a packed arena. Show the hoop, backboard, court lights, crowd depth, and an abstract blue-and-gold lower-third without readable text. Keep the camera angle, ball position, jersey colors, and contact-free action consistent; 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.
Generated with Image 2
Scene: A gray-and-black running shoe hangs at a three-quarter angle above a wet track. Its orange sole glows against a dark background while orange light trails echo the tread and the surface holds a restrained reflection. Preserve the shoe shape, lace pattern, sole, lighting, and empty copy 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.
Generated with Image 2
Scene: A lone astronaut stands inside a glass biodome on a red desert planet, seen from behind among glowing bioluminescent plants. A hazy red landscape and distant mountains show through the curved glass. Hold the character silhouette, plant positions, cool interior light, and wide screen direction for storyboard continuity. No readable text, 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.
Generated with Image 2
Scene: In a bright modern kitchen, a surprised man in a light green overshirt holds an orange while paper sheets and cups burst through the air around him. Freeze the harmless cause-and-effect gag with believable trajectories, warm daylight, and clear spacing between the objects. Keep the pose and prop positions stable for a physical-comedy frame; no injury, logos, readable words, 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.
Generated with Image 2
Scene: A restored black-and-white market street shows period vendors beside baskets of fruit and folded fabric, with stone buildings and mountains behind them. Preserve the era-appropriate clothing, stalls, architecture, film grain, and stable documentary composition while repairing scratches and contrast. Do not add modern objects, readable signs, logos, identifiable public figures, 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.
Why gemini-2.5-flash-image API
Why use gemini-2.5-flash-image through Flatkey?
Use one gateway for gemini-2.5-flash-image, account controls and the rest of your model catalog.
gemini-2.5-flash-image in one API
Keep the gemini-2.5-flash-image model id and endpoint explicit while using the same Flatkey key as other workloads.
Live catalog pricing
See the current gemini-2.5-flash-image billing dimensions before a request is sent, then confirm the final estimate in your account.
A practical model handoff
Test a gemini-2.5-flash-image prompt in the public playground and carry the same settings into an authenticated integration.
Usage and routing controls
Centralize keys, quotas and routing for gemini-2.5-flash-image without changing your application’s provider-facing workflow.
API
gemini-2.5-flash-image API
Four ways in, all on the same key and the same model catalog. Pick one to see a runnable example.
curl https://router.flatkey.ai/v1beta/models/gemini-2.5-flash-image:generateContent \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"gemini-2.5-flash-image","contents":[{"role":"user","parts":[{"text":"Create a high-quality product image with gemini-2.5-flash-image: clean composition, precise lighting, strong subject focus, and realistic detail."}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1"}}}'
FAQ
gemini-2.5-flash-image API
pricing, features, and usage FAQs
Answers about gemini-2.5-flash-image pricing, capabilities, endpoint access and catalog limits.




