Media Generation with StableStudio Skill

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)

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)

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:

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.

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 |

Agent Skills: Media Generation with StableStudio

Install this agent skill to your local

Skill Files