{"uid":"cap_dqHJSkPv7iZMlxPCe1VeG","slug":"stablestudio-edit-76cf3c27","name":"Grok Image Edit","description":"Pay-per-generation AI image and video creation. No subscriptions ever.","url":"https://stablestudio.dev/api/generate/grok/edit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","format":"uri","description":"Image URL"},"minItems":1,"description":"Array of image URLs to edit"},"prompt":{"type":"string","maxLength":8000,"minLength":1,"description":"A detailed description of the image you want to generate"},"aspect_ratio":{"enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","2:1","1:2","19.5:9","9:19.5","20:9","9:20"],"type":"string","default":"16:9","description":"Aspect ratio of the output image"}}},"responseSchema":{"type":"json","example":{"type":"grok-edit","jobId":"cmpbmzaee000j04jrzx4f43tw","status":"pending","pollUrl":"https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw","success":true}},"example":{"request":{"images":["https://www.w3schools.com/css/img_5terre.jpg"],"prompt":"Add a warm golden sunset glow to the background and enhance the overall lighting","aspect_ratio":"16:9"},"response":{"type":"grok-edit","jobId":"cmqbtw5ok000004jye94hdnyw","status":"pending","success":true}},"exampleRequest":{"images":["https://www.w3schools.com/css/img_5terre.jpg"],"prompt":"Add a warm golden sunset glow to the background and enhance the overall lighting","aspect_ratio":"16:9"},"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":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"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_IaKlK027sjEGWGdTZJklC","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_Lk1tHwDBVCTQPyvNrNJi6","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 existing images using Grok Image AI based on a text prompt, returning a pending job ID","exampleAgentPrompt":"Edit this image (https://example.com/photo.jpg) using Grok Image — make the background a sunset sky and add a mountain range in the distance, output in 16:9.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a jobId string, a status of 'pending', a type field, and success: true. The agent must poll the job ID to retrieve the completed edited image.","failureModes":["Invalid or inaccessible image URL returns an error","Prompt exceeds 8000 character limit","No images provided (minItems: 1 not met)","Invalid aspect ratio enum value","Payment of $10 USDC not fulfilled results in 402 response","Job creation may succeed but underlying edit can fail asynchronously"],"whenToPreferThis":"Use this endpoint when you specifically want Grok Image's editing model to modify existing images via text prompt on the StableStudio platform. Prefer this over other StableStudio edit endpoints (Flux 2 Pro, GPT Image, Nano Banana) when Grok's particular visual style or capabilities are desired. Use the generate endpoint instead if starting from scratch with no source image.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":10,"lastUsedAt":"2026-07-23T00:21:35.651Z","lastSuccessfullyRanAt":"2026-05-20T19:07:08.607Z","lastHealthCheckAt":"2026-10-10T06:41:59.525Z","isFirstParty":false,"canonicalSlug":"stablestudio-edit-76cf3c27"}