Media Generation with StableStudio

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

Setup

If the agentcash MCP is not yet installed, see rules/getting-started.md for installation and wallet setup.

Quick Reference

Image Generation

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

agentcash.fetch(
  url="https://stablestudio.dev/api/generate/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)

agentcash.fetch(
  url="https://stablestudio.dev/api/generate/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:

agentcash.fetch_with_auth(
  url="https://stablestudio.dev/api/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.

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

Model Comparison