{"uid":"cap_Df3oXQz6YAIzx6XjEfTvL","slug":"stablestudio-edit-989b68c5","name":"StableStudio Nano Banana Image Edit","description":"Pay-per-generation AI image and video creation. No subscriptions ever.","url":"https://stablestudio.dev/api/generate/nano-banana/edit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","format":"uri","description":"URL of an image"},"maxItems":14,"minItems":1,"description":"Array of image URLs to use as reference for editing (1-14 images)"},"prompt":{"type":"string","minLength":1,"description":"A detailed description of the image you want to generate"},"imageSize":{"enum":["512","1K","2K","4K"],"type":"string","default":"1K","description":"The resolution of the generated image"},"aspectRatio":{"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":"The aspect ratio of the generated image"},"thinkingLevel":{"enum":["minimal","high"],"type":"string","default":"minimal","description":"Thinking level for reasoning (minimal = fastest, high = best quality)"}}},"responseSchema":{"type":"json","example":{"type":"nano-banana-edit","jobId":"cmpbmzaee000j04jrzx4f43tw","status":"pending","pollUrl":"https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw","success":true}},"example":null,"exampleRequest":null,"tags":["image","video","generation","nano-banana","gpt-image","grok","flux","sora","veo","seedance","wan","ai","media","x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.88","successRate":"0.97","reviews":2,"stars":"4.5","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"10","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IrfonvW6I-tzZvQCsAjpz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_y5kjD7NIWROct-VNMq4eC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableStudio","brandSlug":"stablestudio","brandBaseUrl":"https://stablestudio.dev","brandDocsUrl":"https://stablestudio.dev","whatItDoes":"Edits one or more reference images using AI (Nano Banana model) based on a text prompt, returning a job ID for async retrieval","exampleAgentPrompt":"Take these two reference images and edit them together so the subject is wearing a red leather jacket instead of a blue one — use the Nano Banana model at 2K resolution in 16:9 aspect ratio with high thinking level for best quality.","exampleUseCases":[{"title":"Transform product photos for marketing","prompt":"I have 5 product images that need a background change for our catalog. Can you edit them all to have a clean white studio background instead of the current outdoor setting? Use Nano Banana and make sure they're high quality."},{"title":"Modernize old family photos","prompt":"My grandmother sent me some old family photos from the 80s and they feel dated. Can you edit them to look more contemporary while keeping everyone recognizable? Use the Nano Banana model with good quality settings."},{"title":"Create style variations for design mockups","prompt":"I have a reference image of our logo on a t-shirt. Can you edit it a few different ways — one with a gold metallic effect, another with a holographic shimmer, and one more with a vintage distressed look? Use Nano Banana for all three."}],"resultDescription":"Returns a JSON object with a jobId string, a status of 'pending', a type field, and success=true. The agent must poll a separate endpoint using the jobId to retrieve the final edited image once processing completes.","failureModes":["Missing required 'prompt' field returns a validation error","Missing or empty 'images' array returns a validation error","More than 14 images provided exceeds maxItems constraint","Invalid image URL format causes a processing failure","Invalid enum value for imageSize, aspectRatio, or thinkingLevel returns a schema error","Payment not provided or insufficient USDC balance returns a 402 error","Service temporarily unavailable returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to edit or transform existing images using the Nano Banana model specifically, rather than generating from scratch. Prefer this over GPT Image or Flux edit endpoints when the user requests Nano Banana specifically or when experimenting with StableStudio's model variety. Use when you have 1–14 reference images and a text prompt describing the desired edit, and need async job-based processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":86,"lastUsedAt":"2026-09-14T13:08:06.949Z","lastSuccessfullyRanAt":"2026-09-06T13:08:06.184Z","lastHealthCheckAt":"2026-10-09T23:32:50.510Z","isFirstParty":false,"canonicalSlug":"stablestudio-edit-989b68c5"}