| name | media-generation |
| description | Generate images and videos using x402-protected AI models at StableStudio.
USE FOR:
- Generating images from text prompts
- Generating videos from text or images
- Editing images with AI
- Creating visual content
TRIGGERS:
- "generate image", "create image", "make a picture"
- "generate video", "create video", "make a video"
- "edit image", "modify image"
- "stablestudio", "nano-banana", "sora", "veo"
|
| mcp | ["x402"] |
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 |
