MPPtempoquality 0.85

Edit images with Nano Banana Pro using 1–14 reference images, up to 4K resolution, paid per call via USDC.

Price
per_call
Protocol
mpp
Verified
no

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

image-editingmulti-reference-imageup-to-4k-resolutionaspect-ratio-selectionpay-per-callusdc-on-basetempo-l2no-api-keyasync-job-pollingwallet-auth

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 header

Example

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

Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.85/ 1.00

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

Provenance

Indexed frommpp_dev
Enriched2026-04-19 16:48:06Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access