Media Generation

Media Generation with StableStudio

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

Setup

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

Quick Reference

Image Models

All endpoints are prefixed with https://stablestudio.dev/api/generate/. Edit endpoints use /edit instead of /generate.

Video Models

Image Generation

Default: nano-banana-pro. This is the best image model by far — highest quality, supports up to 4K, and the cost is reasonable. Always use nano-banana-pro unless the user specifically requests a different model or has a strong reason to use something else (e.g., budget constraints, needing ultra-wide aspect ratios from grok).

npx agentcash@latest fetch https://stablestudio.dev/api/generate/nano-banana-pro/generate -m POST -b '{
  "prompt": "a cat wearing a space helmet, photorealistic",
  "aspectRatio": "16:9",
  "imageSize": "2K"
}'

nano-banana-pro options:

• aspectRatio: "1:1", "16:9", "9:16"
• imageSize: "1K", "2K", "4K"

Other Image Models

gpt-image-1.5 -- Fastest, cheapest per-image. Uses quality and size instead of aspect ratio:

npx agentcash@latest fetch https://stablestudio.dev/api/generate/gpt-image-1.5/generate -m POST -b '{
  "prompt": "a watercolor painting of a mountain lake",
  "quality": "high",
  "size": "1536x1024"
}'

Options: quality: "low"/"medium"/"high". size: "1024x1024", "1536x1024", "1024x1536". Same schema for gpt-image-1.

grok -- Fast, wide aspect ratio support. Note: uses aspect_ratio (underscore):

npx agentcash@latest fetch https://stablestudio.dev/api/generate/grok/generate -m POST -b '{
  "prompt": "neon cyberpunk cityscape at night",
  "aspect_ratio": "16:9"
}'

Options: aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "2:1", "1:2", "19.5:9", "9:19.5", "20:9", "9:20".

flux-2-pro -- High quality with resolution control:

npx agentcash@latest fetch https://stablestudio.dev/api/generate/flux-2-pro/generate -m POST -b '{
  "prompt": "editorial photo of a vintage car in golden hour light",
  "aspect_ratio": "3:2",
  "resolution": "2 MP"
}'

Options: aspect_ratio: "1:1", "16:9", "9:16", "3:2", "2:3", "4:5", "5:4", "4:3", "3:4". resolution: "0.5 MP", "1 MP", "2 MP".

nano-banana -- Budget option ($0.039). Same schema as nano-banana-pro but without imageSize.

Video Generation

Recommended: veo-3.1 (best quality)

npx agentcash@latest fetch https://stablestudio.dev/api/generate/veo-3.1/generate -m POST -b '{
  "prompt": "a timelapse of clouds moving over mountains",
  "durationSeconds": "6",
  "aspectRatio": "16:9"
}'

veo-3.1 options:

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

veo-3.1 also supports frame interpolation -- animate between a start image and end image by providing image and lastFrame blob URLs in the body.

veo-3.1-fast -- Same schema as veo-3.1, 4x cheaper, ~30s instead of 1-2min.

Other Video Models

seedance -- Good quality with audio generation support. Use seedance/t2v (text-to-video) or seedance/i2v (image-to-video):

npx agentcash@latest fetch https://stablestudio.dev/api/generate/seedance/t2v -m POST -b '{
  "prompt": "a bird taking flight from a branch in slow motion",
  "duration": "8",
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": false,
  "camera_fixed": false
}'

Options: duration: "4"-"12". resolution: "480p", "720p", "1080p". aspect_ratio: "16:9", "9:16", "4:3", "3:4", "1:1", "21:9". For i2v, add "image": "https://blob-url..." and omit generate_audio/camera_fixed.

seedance-fast -- Same schema, 8x cheaper, slightly lower quality.

grok-video -- Cheapest short video option:

npx agentcash@latest fetch https://stablestudio.dev/api/generate/grok-video/generate -m POST -b '{
  "prompt": "a candle flame flickering",
  "duration": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

Options: duration: "3", "6", "9", "12", "15". resolution: "480p", "720p". aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3".

wan-2.6 -- Budget, supports t2v and i2v. duration: "5", "10", "15". t2v uses size ("1280720", "7201280", "19201080", "10801920"); i2v uses resolution ("720p", "1080p") and image.

sora-2 -- seconds: "4", "8", "12". size: "1280x720", "720x1280".

sora-2-pro -- Premium. seconds: "10", "15", "25". size: "1280x720", "720x1280", "1792x1024", "1024x1792".

Job Polling

Generation returns a jobId. Poll until complete:

npx agentcash@latest fetch https://stablestudio.dev/api/jobs/{jobId}

Poll images every 3s, videos every 10s. Result contains imageUrl or videoUrl. fetch handles both paid submission requests and free SIWX polling requests.

Image Editing

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

All image models support /edit. The edit endpoint accepts images (array of blob URLs) plus a prompt.

npx agentcash@latest fetch https://stablestudio.dev/api/generate/nano-banana-pro/edit -m POST -b '{
  "prompt": "change the background to a beach sunset",
  "images": ["https://...blob-url..."]
}'

Grok edit also supports aspect_ratio. GPT-image edit uses the same quality/size options as generate.

Model Comparison

Image Models

Video Models

Getting Started

Setup

1. Install the agentcash CLI:

   npm install -g agentcash

2. Check wallet:

   npx agentcash@latest balance

3. Fund wallet (if needed):

• Redeem invite: npx agentcash@latest redeem YOUR_CODE
• Or run npx agentcash@latest accounts to get Base or Solana deposit links and wallet addresses

Troubleshooting

File Uploads

Upload images for editing or image-to-video. Cost: $0.01 per upload.

Upload Flow

1. Get upload token ($0.01)

npx agentcash@latest fetch https://stablestudio.dev/api/upload -m POST -b '{"filename": "image.png", "contentType": "image/png"}'

Returns: {uploadId, clientToken, pathname}

2. Upload file to Vercel Blob

curl -X PUT "https://vercel.com/api/blob/?pathname={pathname}" \
  -H "authorization: Bearer {clientToken}" \
  -H "x-content-type: image/png" \
  -H "x-api-version: 11" \
  --data-binary @image.png

Returns: {url: "https://....blob.vercel-storage.com/..."}

3. Confirm upload

npx agentcash@latest fetch https://stablestudio.dev/api/upload/confirm -m POST -b '{"uploadId": "...", "blobUrl": "https://..."}'

Use the blobUrl in edit/i2v requests.