{"uid":"cap_9fOf8gIyaSdiitQwJkzPV","slug":"api-imgzen-dev-27650a7b","name":"imgzen Gemini 2.5 Flash Image (nano-banana)","description":"imgzen — Gemini 2.5 Flash Image (aka nano-banana), fast generation by Google — $0.020/image","url":"https://api.imgzen.dev/v1/models/nano-banana/generate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"image":{"type":"array","items":{"type":"string"},"maxItems":5,"description":"Optional reference image(s) for editing (max 5), supports URL and base64"},"prompt":{"type":"string","description":"Text prompt describing the image to generate or edit"},"quality":{"enum":["1k"],"type":"string","default":"1k","description":"Output quality: 1k"},"aspect_ratio":{"enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9"],"type":"string","default":"1:1","description":"Image aspect ratio"}}},"responseSchema":{"type":"object","required":["output","status","payment"],"properties":{"output":{"type":"object","required":["url","model","provider","duration_ms"],"properties":{"url":{"type":"string"},"model":{"type":"string"},"provider":{"type":"string"},"duration_ms":{"type":"number"}}},"status":{"type":"string"},"payment":{"type":"object","required":["amount","method","currency"],"properties":{"amount":{"type":"string"},"method":{"type":"string"},"currency":{"type":"string"}}}}},"example":{"request":{"prompt":"A serene mountain landscape with snow-capped peaks and a clear blue sky","quality":"1k","aspect_ratio":"16:9"},"response":{"output":{"url":"https://cache.imgzen.dev/gen/JNyjUCPsO7QsFswXeI4kW.png","model":"gemini-2.5-flash-image","provider":"imgzen-google","duration_ms":8511},"status":"success","payment":{"amount":"0.0200","method":"x402","currency":"USDC"}}},"exampleRequest":{"prompt":"A serene mountain landscape with snow-capped peaks and a clear blue sky","quality":"1k","aspect_ratio":"16:9"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":5,"rating":{"score":"0.20","successRate":"0.90","reviews":5,"stars":"1.8","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F0pEG5HuZDWLyJVBJ1dmV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates images from text prompts using Google's Gemini 2.5 Flash model, with optional reference images for editing, at $0.02 per image via x402 USDC payment.","exampleAgentPrompt":"Generate a serene mountain landscape with snow-capped peaks and a clear blue sky using Gemini Flash — make it 16:9 widescreen format.","exampleUseCases":[{"title":"Quick product mockup images for catalog","prompt":"I need to generate a bunch of product mockup images for our e-commerce catalog really fast and cheap — can you create 50 lifestyle shots of our water bottle in different settings? Just use Gemini Flash, we don't need perfect quality, just something we can iterate on quickly."},{"title":"Social media graphics for daily posting","prompt":"We're posting daily to Instagram and need fresh AI-generated illustration backgrounds. Can you whip up some abstract geometric designs, maybe 5-10 of them? Keep it fast and under budget — we just need eye-catching squares for our feed."},{"title":"Rapid prototyping UI mockups","prompt":"I'm building a design prototype and need a few placeholder images to show the client how the layout will look. Generate me a professional-looking hero image for a SaaS landing page in 16:9, and maybe a couple of abstract tech-themed graphics — speed matters more than perfection here."}],"resultDescription":"Returns a JSON object with the URL of the generated image hosted on cache.imgzen.dev, the model name (gemini-2.5-flash-image), provider (imgzen-google), generation time in milliseconds, status string, and payment confirmation details (amount in USDC, method x402, currency).","failureModes":["Invalid or unsupported aspect ratio enum value — returns validation error","Prompt missing or empty — request rejected with 400-level error","Reference image URL unreachable or base64 malformed — image fetch failure","Payment via x402 fails or insufficient USDC balance — payment error response","More than 5 reference images provided — exceeds maxItems constraint","Model temporarily unavailable from Google backend — 503 or timeout"],"whenToPreferThis":"Choose this endpoint when you need fast, low-cost image generation at $0.02/image and quality requirements are moderate (1k). Prefer over the nano-banana-pro or nano-banana-2 siblings when cost efficiency is paramount and you don't need best-in-class text rendering or the highest quality output. Ideal for bulk generation, prototyping, or use cases where speed and price matter more than peak quality.","instructions":null,"reviewSummary":"imgzen Gemini 2.5 Flash Image (nano-banana) shows severe reliability issues across tested runs, with 4 out of 5 attempts failing due to Google API quota exhaustion (403), upstream timeouts (HTTP 500), or payment errors (402) — all while charging the $0.020/image fee. One successful run did produce a 1024×1024 PNG in ~13 seconds that matched the prompt, demonstrating the capability works in principle. Overall sentiment is strongly negative due to repeated charges with no deliverable output.","reviewSummaryHighlights":["When functional, generates 1024×1024 PNG images from text prompts in ~13 seconds","Clean output URL and straightforward schema on successful calls"],"reviewSummaryConcerns":["4 of 5 tested calls failed (403 quota exhaustion, HTTP 500 timeouts, 402 errors)","Users charged $0.02 USDC per failed attempt with no image returned","Service appears dependent on imgzen maintaining sufficient upstream Google API quota"],"reviewSummaryGeneratedAt":"2026-06-16T18:15:13.121Z","activationCount":98,"lastUsedAt":"2026-06-16T18:08:35.686Z","lastSuccessfullyRanAt":"2026-05-30T03:57:19.712Z","lastHealthCheckAt":"2026-10-12T16:25:39.394Z","isFirstParty":false,"canonicalSlug":"api-imgzen-dev-27650a7b"}