Edit images with Flux 2 Pro using 1–8 reference images, paid per call via USDC micropayments.
What it does
This endpoint provides image editing via the Flux 2 Pro model on StableStudio, a pay-per-generation AI media platform. You POST a prompt along with 1–8 reference image URLs (previously uploaded via StableStudio's file upload flow) and receive an asynchronous job. The edit operation costs $0.03–$0.06 per call depending on resolution, paid in USDC on Base (or via Tempo L2). No API keys or subscriptions are required — payment is handled inline via the MPP/x402 402-challenge protocol.
The request accepts a text prompt (up to 10,000 characters), an aspect ratio (9 options from 1:1 to 3:4), resolution (0.5 MP, 1 MP, or 2 MP), output format (webp, jpg, png), output quality (0–100), safety tolerance (1–5), prompt upsampling toggle, and an array of 1–8 image URLs. The response returns a job ID with status "pending". You then poll `GET /api/jobs/{jobId}` with a SIGN-IN-WITH-X wallet signature header until the job completes, at which point the result contains an `imageUrl`. Typical turnaround is ~5 seconds.
StableStudio is part of a broader platform offering multiple image and video generation models (Nano Banana Pro, GPT Image 1.5, Grok, Seedance, Wan, Sora, Veo) all accessible through the same payment and job-polling flow. Images for editing must first be uploaded via the three-step `/api/upload` flow ($0.01), which returns a blob URL to pass in the `images` array.
Capabilities
Use cases
- —Editing product photos by providing reference images and a text prompt describing desired changes
- —Restyling or compositing multiple reference images into a new output guided by a prompt
- —Automated batch image editing in agent workflows without API key management
- —Quick iterative image refinement using up to 8 reference images at low per-call cost
- —Generating variations of existing images with controllable aspect ratio and resolution
Fit
Best for
- —Agents needing low-cost, keyless image editing via micropayments
- —Workflows requiring multi-reference-image editing with Flux 2 Pro quality
- —Developers who want pay-per-call pricing without subscriptions
Not for
- —Real-time or synchronous image editing (this is async with ~5s latency)
- —Users without a crypto wallet (USDC on Base or Tempo required for payment)
- —High-volume batch jobs where subscription pricing would be cheaper
Quick start
# 1. POST without payment to get 402 challenge
curl -X POST https://stablestudio.dev/api/generate/flux-2-pro/edit \
-H 'Content-Type: application/json' \
-d '{"prompt": "Make the background a sunset", "images": ["https://blob-url..."], "aspect_ratio": "16:9", "resolution": "1 MP"}'
# Returns 402 with PAYMENT-REQUIRED header containing USDC amount
# 2. Sign USDC payment, re-POST with PAYMENT-SIGNATURE header
# 3. Poll GET /api/jobs/{jobId} with SIGN-IN-WITH-X headerExample
Request
{
"images": [
"https://example.blob.vercel-storage.com/uploads/abc/photo.png"
],
"prompt": "Make the background a sunset over the ocean",
"resolution": "1 MP",
"aspect_ratio": "16:9",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2,
"prompt_upsampling": false
}Response
{
"type": "flux-2-pro-edit",
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"success": true
}Endpoint
Quality
Full OpenAPI schema with detailed input/output definitions, clear pricing ($0.03–$0.06), comprehensive guidance docs, and well-documented payment flow. The probe returned 405 (not 402) because the endpoint only accepts POST, not HEAD/GET — this is expected behavior, not a liveness issue. Minor deduction for no direct 402 capture on this specific endpoint and no dedicated docs page (404).
Warnings
- —Probe returned 405 because HEAD/GET are not supported; endpoint requires POST method
- —File upload flow ($0.01 per upload) is a prerequisite for providing reference images
- —Requires a crypto wallet with USDC on Base (eip155:8453) or Tempo L2 for payment
Citations
- —Flux 2 Pro edit costs $0.03–$0.06 per call with ~5s turnaroundhttps://stablestudio.dev
- —Edit endpoint accepts 1–8 reference images with prompt, aspect_ratio, resolution, output_format, output_quality, safety_tolerance, and prompt_upsampling parametershttps://stablestudio.dev
- —Payment is USDC on Base (eip155:8453) with 6 decimals; amount in micro-unitshttps://stablestudio.dev
- —File upload flow costs $0.01 and uses a three-step process via Vercel Blobhttps://stablestudio.dev
- —Job polling uses SIGN-IN-WITH-X wallet signature authentication at GET /api/jobs/{jobId}https://stablestudio.dev
- —Platform supports both x402 and MPP (Tempo) payment protocolshttps://stablestudio.dev