{"uid":"cap_QH9DJEh3QvdPoKo7UwDU0","slug":"gorilla-farm-image-generation-editing-api-b99ca352","name":"gorilla.farm Image Generation & Editing API","description":"Generate or edit an image (Nano Banana 2)","url":"https://gorilla.farm/api/generate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":1000,"description":"Text description for generation or editing instruction"},"image_url":{"type":"string","format":"uri","description":"Optional: URL of image to edit. If omitted, generates new image."},"aspect_ratio":{"enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9","auto"],"type":"string","default":"1:1","description":"Image aspect ratio for generation. Defaults to 1:1."}}},"responseSchema":{"type":"json","example":{"image_url":"https://img.gorilla.farm/123e4567-e89b-12d3-a456-426614174000.png"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V3M1gRzlNQmUaSgpnJwCC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a new image from a text prompt or edits an existing image using the Nano Banana 2 model","exampleAgentPrompt":"Using the Nano Banana 2 model on gorilla.farm, generate a photorealistic image of a misty mountain forest at sunrise in 16:9 aspect ratio.","exampleUseCases":[{"title":"Create product mockup images for listings","prompt":"I need you to generate a few product images for my online store. Can you create photorealistic images of a sleek wireless headphone in matte black from different angles? Make them widescreen so they work well for banner ads."},{"title":"Design social media graphics on demand","prompt":"My social media team needs a new hero image for our sustainability campaign. Can you generate a square image of a lush green forest with solar panels integrated into the landscape, with a warm golden hour lighting?"},{"title":"Transform user photos into artistic styles","prompt":"I have a customer photo from our event that I'd like to enhance. Can you edit this image to make it look like an oil painting with vibrant autumn colors, keeping the original composition but making it more artistic and dreamy?"}],"resultDescription":"A JSON object containing a single field 'image_url' pointing to a hosted PNG image file on the gorilla.farm CDN (e.g. https://img.gorilla.farm/<uuid>.png)","failureModes":["Invalid or unreachable image_url when editing — server may fail to fetch the source image","Prompt exceeds 1000 character limit — request rejected","Unsupported aspect ratio value — validation error","Model unavailable or overloaded — 5xx error","Payment failure for the $0.20 USDC x402 charge — 402 response"],"whenToPreferThis":"Choose this endpoint when you need AI-generated or AI-edited images powered by the Nano Banana 2 model, especially when operating in an x402 micropayment environment where per-call USDC billing is acceptable. Good for agents that need one-off image generation without managing API keys or subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-02T19:26:07.761Z","lastSuccessfullyRanAt":"2026-07-02T19:26:07.761Z","lastHealthCheckAt":"2026-10-11T05:28:21.871Z","isFirstParty":false,"canonicalSlug":"gorilla-farm-image-generation-editing-api-b99ca352"}