Media Generation

Media Generation with StableStudio

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

Quick Reference

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

File Uploads

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

Upload Flow

1. Get upload token ($0.01)

x402.fetch(
  url="https://stablestudio.io/api/x402/uploads",
  method="POST",
  body={"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

x402.fetch_with_auth(
  url="https://stablestudio.io/api/x402/uploads/confirm",
  method="POST",
  body={"uploadId": "...", "blobUrl": "https://..."}
)

Use the blobUrl in edit/i2v requests.