{"uid":"cap_35UdpxsAVYp356OyUr3Pe","slug":"api-imgzen-dev-e4667357","name":"imgzen Gemini 3.1 Flash Image Generator (nano-banana-2)","description":"imgzen — Gemini 3.1 Flash Image (aka nano-banana-2), fast high-quality generation by Google — $0.100/image","url":"https://api.imgzen.dev/v1/models/nano-banana-2/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","2k","4k"],"type":"string","default":"2k","description":"Output quality: 1k, 2k, 4k"},"aspect_ratio":{"enum":["1:1","1:4","1:8","2:3","3:2","3:4","4:1","4:3","4:5","5:4","8:1","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 lake at sunset with pine trees reflected in calm water","quality":"2k","aspect_ratio":"16:9"},"response":{"output":{"url":"https://cache.imgzen.dev/gen/zzub5hthPo-wPqWblunIr.jpg","model":"gemini-3.1-flash-image-preview","provider":"imgzen-google","duration_ms":18824},"status":"success","payment":{"amount":"0.1000","method":"x402","currency":"USDC"}}},"exampleRequest":{"prompt":"A serene mountain lake at sunset with pine trees reflected in calm water","quality":"2k","aspect_ratio":"16:9"},"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.42","successRate":"0.43","reviews":2,"stars":"2.7","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qc4eTXigPruBUndO-h1FT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates or edits images using Google's Gemini 3.1 Flash Image model at configurable quality and aspect ratio, paid via x402 USDC microtransaction","exampleAgentPrompt":"Generate a 2k quality image of a serene mountain lake at sunset with pine trees reflected in calm water, in 16:9 widescreen format using Google's Gemini Flash model.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the URL of the generated image hosted on imgzen's CDN, the model identifier (gemini-3.1-flash-image-preview), provider name, generation time in milliseconds, a success status string, and payment confirmation showing 0.1 USDC charged via x402.","failureModes":["Invalid prompt (empty or too long) — 400 Bad Request","Unsupported aspect_ratio or quality enum value — 400 Bad Request","Payment failure or insufficient USDC balance — 402 Payment Required","Reference image URL unreachable or invalid base64 — 422 Unprocessable Entity","Exceeded 5 reference images limit — 400 Bad Request","Model temporarily unavailable — 503 Service Unavailable","Generation timeout (model too slow) — 504 Gateway Timeout"],"whenToPreferThis":"Choose this endpoint when you need fast, high-quality image generation at $0.10/image and want a balance between speed and quality from Google's Gemini lineup. Prefer this over the cheaper nano-banana ($0.020) when you need better quality, and over nano-banana-pro ($0.200) when best-in-class text rendering is not required. Best for landscape, portrait, and creative scene generation where generation latency matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":21,"lastUsedAt":"2026-06-16T18:11:09.725Z","lastSuccessfullyRanAt":"2026-05-13T22:11:02.096Z","lastHealthCheckAt":"2026-10-12T16:27:00.338Z","isFirstParty":false,"canonicalSlug":"api-imgzen-dev-e4667357"}