GPT Image 1.5 generation via micropayments — $0.009–$0.20 per image, ~3s, no API key needed.
What it does
This endpoint generates images using OpenAI's GPT Image 1.5 model, accessed through StableStudio's pay-per-call micropayment platform. It accepts a text prompt and optional parameters for quality (low/medium/high), size (1024x1024, 1536x1024, 1024x1536, or auto), background (transparent/opaque/auto), output format (png/jpeg/webp), compression level, and content moderation strictness. Pricing is dynamic, ranging from $0.009 to $0.20 per generation depending on quality and size settings. Generation takes approximately 3 seconds.
Payment is handled via the MPP protocol (Tempo method on pathUSD) or x402 (USDC on Base, network eip155:8453). No API keys or subscriptions are required — callers POST to the endpoint, receive a 402 payment challenge, sign a USDC/pathUSD authorization, then resubmit with a PAYMENT-SIGNATURE header. The response returns a jobId with status "pending"; callers then poll GET /api/jobs/{jobId} with a SIGN-IN-WITH-X wallet signature header until the job completes and returns an imageUrl.
StableStudio also exposes a companion edit endpoint at /api/generate/gpt-image-1.5/edit that accepts reference images for image editing tasks. The platform hosts many other models (Nano Banana Pro, Flux 2 Pro, Grok, Seedance, Wan, Sora, Veo) for both image and video generation, all using the same payment flow. An MCP server is available via `npx -y agentcash@latest` for agent integration.
Capabilities
Use cases
- —Generate images from text prompts with configurable quality and size
- —Create images with transparent backgrounds for design assets
- —Produce quick low-cost draft images at $0.009 per call
- —Agent-driven image generation with crypto micropayments
- —Batch image creation workflows without subscription commitments
Fit
Best for
- —Agents or apps needing fast, cheap text-to-image with no API key signup
- —Generating images with transparent backgrounds (PNG output)
- —Low-latency image generation (~3 seconds)
- —Crypto-native applications paying per call with USDC or pathUSD
Not for
- —High-volume batch jobs where subscription pricing would be cheaper
- —Users without a crypto wallet (requires USDC on Base or pathUSD on Tempo)
- —Image editing with reference images (use the /edit endpoint instead)
Quick start
# 1. Send request without payment to get 402 challenge
curl -X POST https://stablestudio.dev/api/generate/gpt-image-1.5/generate \
-H 'Content-Type: application/json' \
-d '{"prompt": "A cat astronaut floating in space", "quality": "high", "size": "1024x1024"}'
# Returns 402 with PAYMENT-REQUIRED header (base64 JSON)
# 2. Decode challenge, sign USDC payment, resend with PAYMENT-SIGNATURE header
# 3. Poll GET /api/jobs/{jobId} with SIGN-IN-WITH-X header until completeExample
Request
{
"size": "1024x1024",
"prompt": "A cat astronaut floating in space, photorealistic",
"quality": "high",
"background": "opaque",
"moderation": "auto",
"output_format": "png"
}Response
{
"type": "gpt-image-1.5",
"jobId": "abc123-def456",
"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 probes (expected since it's POST-only), but the OpenAPI spec and guidance docs confirm it is live and well-documented. Minor deduction for no direct 402 challenge captured on this specific endpoint and no dedicated docs page.
Warnings
- —Probe returned 405 because HEAD/GET were used on a POST-only endpoint; this does not indicate the endpoint is down
- —Requires a crypto wallet with USDC on Base (eip155:8453) or pathUSD on Tempo to make payments
- —No dedicated documentation page found (/docs returns 404); all docs are embedded in OpenAPI x-guidance
Citations
- —GPT Image 1.5 generate costs $0.009–$0.20 per call and takes ~3shttps://stablestudio.dev
- —Payment is via USDC on Base (eip155:8453) or Tempo method with pathUSDhttps://stablestudio.dev
- —Input schema supports prompt, quality, size, background, output_format, output_compression, and moderation parametershttps://stablestudio.dev
- —MCP server available via npx -y agentcash@latesthttps://stablestudio.dev
- —agents.txt lists gpt-image-1.5 at $0.009-0.20 with ~3s latencyhttps://stablestudio.dev