{"uid":"cap_Tqmrl9JnXUTmnk_xBTpk3","slug":"stablestudio-flux-2-pro-image-edit-d69f068f","name":"StableStudio Flux 2 Pro Image Edit","description":"Pay-per-generation AI image and video creation. No subscriptions ever.","url":"https://stablestudio.io/api/generate/flux-2-pro/edit","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"seed":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Random seed for reproducibility"},"images":{"type":"array","items":{"type":"string","format":"uri","description":"Image URL"},"maxItems":8,"minItems":1,"description":"Array of image URLs to use as references for editing"},"prompt":{"type":"string","maxLength":10000,"minLength":1,"description":"A detailed description of the image you want to generate"},"resolution":{"enum":["0.5 MP","1 MP","2 MP"],"type":"string","default":"1 MP","description":"Output resolution in megapixels"},"aspect_ratio":{"enum":["1:1","16:9","9:16","3:2","2:3","4:5","5:4","4:3","3:4"],"type":"string","default":"1:1","description":"Aspect ratio of the output image"},"output_format":{"enum":["webp","jpg","png"],"type":"string","default":"webp","description":"Output image format"},"output_quality":{"type":"integer","default":80,"maximum":100,"minimum":0,"description":"Quality for JPG/WebP output (0-100)"},"safety_tolerance":{"type":"integer","default":2,"maximum":5,"minimum":1,"description":"Content safety strictness (1=strict, 5=permissive)"},"prompt_upsampling":{"type":"boolean","default":false,"description":"Let the model enhance your prompt for more creative results"}}},"responseSchema":{"type":"json","example":{"type":"flux-2-pro-edit","jobId":"cmpbmzaee000j04jrzx4f43tw","status":"pending","pollUrl":"https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw","success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pXAUoHeOrQEWphdt-NZjg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a new AI image using the Flux 2 Pro model with full control over resolution, aspect ratio, format, and safety tolerance, returning an async job ID.","exampleAgentPrompt":"Use StableStudio to generate a photorealistic 4MP image of a misty mountain valley at sunrise with a 16:9 aspect ratio, PNG format at quality 95, strict safety (level 1), and use seed 42 so I can reproduce it — the prompt is 'golden morning light breaking through fog over a lush green mountain range with a winding river below'.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the job ID (jobId), job status ('pending'), generation type ('flux-2-pro-edit'), and a success boolean. The agent must use the jobId to poll for the completed image separately.","failureModes":["Missing required 'prompt' field returns a validation error","Prompt exceeding 10,000 characters is rejected","Invalid enum value for aspect_ratio, resolution, or output_format causes a 400 error","Safety tolerance outside 1-5 range is rejected","Output quality outside 0-100 range is rejected","Payment of $10 USDC not completed results in 402 Payment Required","Seed value outside valid integer range is rejected","Server-side generation failure may return success:false with an error message"],"whenToPreferThis":"Choose this endpoint when you need pay-per-generation Flux 2 Pro image creation without a subscription commitment, especially when you want precise control over resolution (up to 4MP), aspect ratio, output format, and reproducibility via seed. Prefer this over subscription-based services for one-off or low-volume image generation tasks where cost-per-call pricing is more efficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:29.959Z","isFirstParty":false}