Edit images with Nano Banana Pro using 1–14 reference images, up to 4K resolution, paid per call via USDC.
What it does
This endpoint provides AI image editing via the Nano Banana Pro model on StableStudio. It accepts a text prompt along with 1–14 reference images (uploaded via StableStudio's blob upload flow) and produces an edited image at up to 4K resolution. Output aspect ratios include 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, and 21:9. Typical generation time is ~10 seconds.
Pricing is dynamic, ranging from $0.13 to $0.24 per call, paid in USDC on Base (EIP-155:8453) or via Tempo L2 (pathUSD). No API keys or subscriptions are required — payment is handled inline via the MPP/x402 402-challenge flow. The caller POSTs without a payment header, receives a 402 with payment requirements, signs a USDC authorization, and re-submits with a PAYMENT-SIGNATURE header. The response returns a jobId which is polled via GET /api/jobs/{jobId} (authenticated with SIGN-IN-WITH-X wallet signature) until the result imageUrl is available.
Reference images must first be uploaded through StableStudio's three-step file upload flow (POST /api/upload for a token at $0.01, PUT to Vercel Blob, then POST /api/upload/confirm). The resulting blobUrls are passed in the `images` array. The endpoint is POST-only; the probe's HEAD/GET attempts returned 405, which is expected behavior for this route.
Capabilities
Use cases
- —Editing product photos using reference images and text prompts
- —Remixing or restyling existing images at up to 4K resolution
- —Automated batch image editing in agent workflows with per-call crypto payments
- —Combining multiple reference images into a single edited output
- —Creating variations of existing artwork or designs
Fit
Best for
- —Agents needing pay-per-call image editing without subscriptions
- —Workflows requiring high-resolution (up to 4K) edited images
- —Multi-reference image editing (up to 14 source images)
- —Developers integrating crypto-native micropayment image APIs
Not for
- —Text-to-image generation from scratch (use the /generate endpoint instead)
- —Real-time or sub-second image editing (typical latency ~10s)
- —Users without a crypto wallet or USDC on Base
Quick start
# 1. POST without payment to get 402 challenge
curl -X POST https://stablestudio.dev/api/generate/nano-banana-pro/edit \
-H 'Content-Type: application/json' \
-d '{"prompt": "Make the background a sunset", "images": ["https://your-blob-url.vercel-storage.com/img.png"], "imageSize": "2K", "aspectRatio": "16:9"}'
# Returns 402 with PAYMENT-REQUIRED header — decode, sign USDC, re-POST with PAYMENT-SIGNATURE headerExample
Request
{
"images": [
"https://example.blob.vercel-storage.com/uploads/abc/photo.png"
],
"prompt": "Make the background a sunset over the ocean",
"imageSize": "2K",
"aspectRatio": "16:9"
}Response
{
"type": "nano-banana-pro-edit",
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"success": true
}Endpoint
Quality
Full OpenAPI schema with detailed input/output definitions, clear pricing, comprehensive payment flow documentation, and agents.txt present. The endpoint returned 405 on HEAD/GET (expected for POST-only), so liveness is inferred from the OpenAPI spec and overall platform availability (root returns 200). Slightly below 0.9 because the probe did not capture an actual 402 challenge for this specific endpoint.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint is POST-only; liveness inferred from OpenAPI spec and root 200 status
- —Reference images require a separate paid upload flow ($0.01 per upload) before they can be used in edit requests
Citations
- —Nano Banana Pro edit costs $0.13–$0.24 per call with ~10s generation timehttps://stablestudio.dev
- —Edit endpoint accepts 1–14 reference images with imageSize options 1K/2K/4Khttps://stablestudio.dev
- —Payment is USDC on Base (eip155:8453) or Tempo L2 pathUSD, no API keys requiredhttps://stablestudio.dev
- —File upload flow costs $0.01 and uses Vercel Blob storagehttps://stablestudio.dev
- —Model described as best quality/cost ratio for image tasks in x-guidancehttps://stablestudio.dev