Media Generation with StableStudio

Generate images and videos via x402 payments at https://stablestudio.io.

Quick Reference

Task	Endpoint	Cost	Time
Image (default)	`/api/x402/nano-banana-pro/generate`	$0.13-0.24	~10s
Image (budget)	`/api/x402/nano-banana/generate`	$0.039	~5s
Video (default)	`/api/x402/veo-3.1/generate`	$1.60-3.20	1-2min
Video (budget)	`/api/x402/wan-2.5/t2v`	$0.34-1.02	2-5min
Image edit	`/api/x402/nano-banana-pro/edit`	$0.13-0.24	~10s

Image Generation

Recommended: nano-banana-pro (best quality/cost)

mcp

x402.fetch(
  url="https://stablestudio.io/api/x402/nano-banana-pro/generate",
  method="POST",
  body={
    "prompt": "a cat wearing a space helmet, photorealistic",
    "aspectRatio": "16:9",
    "imageSize": "2K"
  }
)

Options:

•aspectRatio: "1:1", "16:9", "9:16"
•imageSize: "1K", "2K", "4K" (nano-banana-pro only)

Video Generation

Recommended: veo-3.1 (best quality/cost)

mcp

x402.fetch(
  url="https://stablestudio.io/api/x402/veo-3.1/generate",
  method="POST",
  body={
    "prompt": "a timelapse of clouds moving over mountains",
    "durationSeconds": "6",
    "aspectRatio": "16:9"
  }
)

Options:

•durationSeconds: "4", "6", "8"
•aspectRatio: "16:9", "9:16"

Job Polling

Generation returns a jobId. Poll until complete:

mcp

x402.fetch_with_auth(
  url="https://stablestudio.io/api/x402/jobs/{jobId}"
)

Poll images every 3s, videos every 10s. Result contains imageUrl or videoUrl.

Image Editing

Requires uploading the source image first. See rules/uploads.md.

mcp

x402.fetch(
  url="https://stablestudio.io/api/x402/nano-banana-pro/edit",
  method="POST",
  body={
    "prompt": "change the background to a beach sunset",
    "images": ["https://...blob-url..."]
  }
)

Model Comparison

Model	Type	Best For
nano-banana-pro	Image	General purpose, up to 4K
nano-banana	Image	Quick drafts, budget
gpt-image-1.5	Image	Fast, variable quality
veo-3.1	Video	High quality, 1080p
wan-2.5	Video	Budget, text or image input
sora-2	Video	Premium quality