Nano Banana Pro image editing via micropayments — up to 14 reference images, up to 4K resolution
What it does
This endpoint provides AI image editing using the Nano Banana Pro model, hosted on StableStudio. It accepts a text prompt along with 1–14 reference image URLs and produces an edited image at up to 4K resolution. Aspect ratios supported include 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, and 21:9. The edit operation costs $0.13–$0.24 per call and typically completes in ~10 seconds.
Payment is handled via the MPP/x402 micropayment protocol using USDC on Base (EIP-155:8453). No API keys or subscriptions are required — callers POST to the endpoint without payment to receive a 402 challenge, then sign a USDC authorization and resubmit 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 is ready. Reference images must first be uploaded through the /api/upload flow ($0.01 per upload) to obtain blob URLs.
StableStudio is part of a broader platform offering multiple image and video generation models including GPT Image 1.5, Flux 2 Pro, Grok, Seedance, Wan 2.6, Sora 2, and Veo 3.1. The endpoint is a POST-only route; the probe returned 405 on HEAD/GET, which is expected behavior for a POST endpoint. An MCP server is available via `npx -y agentcash@latest`.
Capabilities
Use cases
- —Editing product photos using text prompts and reference images
- —Restyling or compositing images with up to 14 references at up to 4K resolution
- —Agent-driven image editing workflows with per-call USDC micropayments
- —Batch image editing without subscription commitments
- —Creating variations of existing images guided by text descriptions
Fit
Best for
- —Agents or apps needing pay-per-call image editing without API keys
- —Reference-based image editing with multiple source images
- —High-resolution (up to 4K) image editing at low per-call cost
- —Crypto-native workflows settling in USDC on Base
Not for
- —Real-time or sub-second image editing (results take ~10s plus polling)
- —Users without a crypto wallet for USDC payments
- —Free or unlimited-use image editing needs
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"], "aspectRatio": "16:9", "imageSize": "2K"}'
# Returns 402 with PAYMENT-REQUIRED header
# 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",
"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 ($0.13–$0.24), documented payment flow, and comprehensive guidance. The probe returned 405 because the endpoint is POST-only, which is expected. Deducted slightly because no direct 402 challenge was captured for this specific endpoint and crawled docs pages return 404.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint is POST-only, which is expected but means no live 402 challenge was captured for this specific route
- —Reference images require a separate paid upload flow ($0.01 per upload via /api/upload) before they can be used
- —No dedicated documentation pages found (stablestudio.dev/docs returns 404); all docs are in the OpenAPI x-guidance field
Citations
- —Nano Banana Pro edit costs $0.13–$0.24 per call and takes ~10shttps://stablestudio.dev/api/openapi.json
- —Edit endpoint accepts 1–14 reference images with prompt, aspectRatio, and imageSize fieldshttps://stablestudio.dev/api/openapi.json
- —Payment is USDC on Base (EIP-155:8453) with 6 decimalshttps://stablestudio.dev/api/openapi.json
- —MCP server available via npx -y agentcash@latesthttps://stablestudio.dev/.well-known/agents.txt
- —File upload flow costs $0.01 per uploadhttps://stablestudio.dev/api/openapi.json