{"uid":"cap_j2uX4qbSZi9mDtRgxTY8B","slug":"stablestudio-edit-e5cdfa10","name":"StableStudio Flux 2 Pro Image Edit","description":"Pay-per-generation AI image and video creation. No subscriptions ever.","url":"https://stablestudio.dev/api/generate/flux-2-pro/edit?utm_source=zero.xyz","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":{"request":{"seed":42,"images":["https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?w=400"],"prompt":"Transform this portrait with warm golden hour lighting and enhance the skin tones","resolution":"1 MP","aspect_ratio":"1:1","output_format":"webp","output_quality":80,"safety_tolerance":2,"prompt_upsampling":false},"response":{"type":"flux-2-pro-edit","jobId":"cmqd9bn2r000b04l7xizeurh9","status":"pending","success":true}},"exampleRequest":{"seed":42,"images":["https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?w=400"],"prompt":"Transform this portrait with warm golden hour lighting and enhance the skin tones","resolution":"1 MP","aspect_ratio":"1:1","output_format":"webp","output_quality":80,"safety_tolerance":2,"prompt_upsampling":false},"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":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_qnAFcxRPymdZIGC5Y1TlS","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_hYeoEHgELyOIPAQAcSrTj","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":"Edit and transform existing images using Flux 2 Pro, guided by a text prompt, returning an async job ID","exampleAgentPrompt":"Edit this product photo (https://example.com/product.jpg) using Flux 2 Pro — make the background a snowy mountain landscape and change the lighting to golden hour; output as a 1:1 PNG at 1 MP and quality 90.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a jobId (string), status set to 'pending', success: true, and a type field. The agent must poll a separate job-status endpoint using the jobId to retrieve the final edited image URL once processing completes.","failureModes":["Invalid or inaccessible image URL returns a 4xx error","Prompt exceeds 10,000 character limit returns validation error","images array empty or exceeds 8 items returns schema validation error","Safety tolerance too low for requested content results in content policy rejection","Insufficient USDC balance / payment failure returns 402","Job remains in pending state if upstream Flux 2 Pro service is overloaded"],"whenToPreferThis":"Choose this endpoint when you need to edit or transform existing images using the Flux 2 Pro model specifically, rather than generating from scratch. Prefer over GPT Image or Nano Banana editing endpoints when Flux 2 Pro's photorealistic style and fine-grained prompt control are desired. Use when the user supplies one or more reference images and wants AI-guided modifications rather than pure text-to-image generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T23:38:38.716Z","isFirstParty":false,"canonicalSlug":"stablestudio-edit-e5cdfa10"}