sirv-ai-studio（西尔夫艾工作室）

Sirv AI Studio

IMPORTANT: Use MCP Tools When Available

Before telling users to visit sirv.studio, CHECK if you have access to sirv-ai MCP tools. If tools like sirv_remove_background, sirv_upscale, sirv_generate are available, USE THEM DIRECTLY to process images.

MCP Tool Quick Reference

If MCP Tools Are NOT Available

Help the user install the Sirv AI MCP server. Add to project .mcp.json or ~/.claude.json:

{
  "mcpServers": {
    "sirv-ai": {
      "command": "npx",
      "args": ["-y", "sirv-ai-mcp-server"],
      "env": {
        "SIRV_AI_BASE_URL": "https://www.sirv.studio"
      }
    }
  }
}

Then restart Claude Code. User will need to authorize with their Sirv AI Studio account on first use.

Only direct users to www.sirv.studio if they don't want to set up MCP.

Web UI (Fallback)

If MCP tools are not available, users can access Sirv AI Studio at www.sirv.studio:

1. Upload image(s) via drag-drop or URL
2. Select tool from sidebar
3. Configure options
4. Click Process
5. Download or auto-upload to Sirv CDN

Core Tools

Background Processing

Background Removal Models:

• BiRefNet v1/v2: Fast, multiple presets (Light, Heavy, Portrait, Matting)
• Bria: Premium quality alternative

Background Replace Models:

• Bria: Text prompt or reference image
• FLUX Kontext: Advanced with consistency
• Nano Banana: Faster alternative

Image Enhancement

Upscaling Models:

• ESRGAN: Fast, affordable (1-2 credits, up to 8x)
• Clarity: AI-enhanced with prompts (8+ credits)
• Topaz: Premium quality (8-136 credits)

Image Generation

Supports: 1-4 images per generation, multiple aspect ratios, up to 2048x2048

Product Tools

Lifestyle Scenes: 44 presets (kitchen, office, beach, etc.) or custom prompts

3D Generation

Output formats: GLB, OBJ, FBX, USDZ, Blend, STL with PBR textures

Video Tools

Free Tools

• Depth Map: Generate depth data for 3D/AR effects
• Image Optimizer: 17 social media presets, resize/crop/convert
• Smart Crop: Intelligent cropping for platforms

Batch Processing

Process multiple images simultaneously:

1. Upload batch via drag-drop or URL import
2. Configure shared settings
3. Preview results before processing
4. Download ZIP or auto-upload to Sirv

Available batch tools:

• Batch Background Removal
• Batch Upscale
• Batch Generate
• Batch Product Lifestyle
• Batch Background Replace
• Batch Alt Text
• Batch Image Translation

Limits by tier:

• Free: No batch
• Starter: 100 images
• Pro: 500 images
• Business: 1,500 images
• Volume+: Unlimited

Workflow Builder (Orchestrator)

Visual DAG pipeline builder for multi-step operations:

Capabilities:

• Chain tools: Remove BG → Upscale → Lifestyle → Alt Text
• AI routing: Classify images → branch to different pipelines
• Quality loops: Review → Autofix → Final Review
• Multi-source: Combine images from different inputs

Example workflows:

• Amazon-Ready: Remove BG → Validate → Autofix → Alt text
• Fashion: Ghost mannequin → Remove BG → Shadow → Bundle
• Color Variants: Remove BG → Generate colors → Review

Credit System

Pricing Tiers

Credit Packs (One-time)

• 50 credits: $4.99
• 100 credits: $9.99
• 500 credits: $39.99
• 1,000 credits: $69.99
• 2,500 credits: $149.99

Bonus credits on top-ups: Free 0%, Starter 5%, Pro 10%, Business 15%, Volume+ 20%

Sirv CDN Integration

Connect Sirv account for:

• Browse Sirv library in app
• Auto-upload processed images
• Per-tool upload destinations (e.g., /products/cutouts/)
• Instant global CDN delivery
• Shopify integration sync

Sirv plan bonuses:

• Business: +50 credits
• Enterprise: +150 credits

Integrations

Quality Control

Image Review Tool (1 credit):

• Checks against marketplace rules
• Validates: dimensions, background, watermarks, frame fill
• Presets: Amazon, eBay, Shopify, Walmart

Marketplace Optimizer:

• Upload → Select marketplaces → Get compliance scorecard
• One-click fixes for all issues

File Formats

Input: JPG, PNG, WebP, GIF, AVIF, HEIF, BMP, TIFF

Output: PNG, JPEG, WebP, GIF (images), MP4/WebM (video), GLB/OBJ/FBX/USDZ/STL (3D)

Tips

• Eager upload: Files upload immediately on selection for faster processing
• Hash caching: Identical files skip re-upload
• Soft delete: Recover deleted assets from trash
• Mobile: Long-press for context menu actions
• Shortcuts: Use keyboard shortcuts in dashboard for power workflows

MCP Server Integration

Sirv AI Studio provides an MCP (Model Context Protocol) server for AI assistants like Claude, enabling natural language image processing directly in conversations.

Available MCP Tools

Background Processing

Background Removal Models:

• General Use (Light) - Fast processing
• General Use (Light 2K) - Fast, higher resolution
• General Use (Heavy) - Best quality (default)
• Matting - For hair/fur details
• Portrait - Optimized for people
• General Use (Dynamic) - Adaptive

Operating Resolutions: 1024x1024, 2048x2048, 2304x2304

Image Enhancement

Upscale Models:

• esrgan - Fast, general purpose (default)
• clarity - AI-enhanced with prompt guidance
• topaz - Premium quality

Image-to-Image Models:

• reve-fast-edit - Quick prompt-based edits (default)
• flux2-lora - High quality transformations
• qwen-integrate-product - Product integration

Image Generation

Generation Models: zimage (fast), flux2 (detailed), gemini (photorealistic), seedream (artistic)

Aspect Ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9

Product & E-commerce

Placement Types: original, automatic (default), manual_placement, manual_padding

Positions: bottom_center, bottom_left, bottom_right, upper_center, upper_left, upper_right, center_vertical, center_horizontal, left_center, right_center

Alt Text Detail Levels: caption (brief), detailed-caption (standard), more-detailed-caption (comprehensive)

3D & Video

3D Models: meshy (default), meshy-multi, seed3d, trellis, trellis2, hunyuan3d

Video Models: veo31 (default), ltx, kling, sora

Video Resolutions: 720p, 1080p, 1440p, 2160p

Batch Operations

Batch Limits: Up to 100 images per request

Account

MCP Usage Examples

Remove background from a product image:

"Remove the background from https://example.com/product.jpg using the Heavy model"
→ sirv_remove_background(image_url, model="General Use (Heavy)")

Create lifestyle scene:

"Place this product on a modern kitchen counter with morning light"
→ sirv_product_lifestyle(image_url, scene_description="Modern kitchen counter with morning light")

Generate product variations:

"Generate 4 images of a minimalist water bottle on white background"
→ sirv_generate(prompt="minimalist water bottle on white background", num_images=4)

Upscale for print:

"Upscale this image 4x using the Topaz model for print quality"
→ sirv_upscale(image_url, scale=4, model="topaz")

Virtual try-on:

"Show this dress on the model photo"
→ sirv_virtual_try_on(person_image_url, garment_image_url)

Batch processing:

"Remove backgrounds from all these product images"
→ sirv_batch_remove_background(images=[{id: "1", image_url: "..."}, ...])

Check credits:

"How many credits do I have left?"
→ sirv_get_usage()

MCP Server Setup

Claude Code (.mcp.json in project or ~/.claude.json global):

{
  "mcpServers": {
    "sirv-ai": {
      "command": "npx",
      "args": ["-y", "sirv-ai-mcp-server"],
      "env": {
        "SIRV_AI_BASE_URL": "https://www.sirv.studio"
      }
    }
  }
}

Restart Claude Code after adding. Authorize with Sirv AI Studio account on first use.

Best Practices

1. Check usage first - Use sirv_get_usage before large batch operations
2. Use appropriate models - Choose quality vs speed based on needs
3. Batch when possible - Use batch tools for multiple images to reduce overhead
4. Provide clear prompts - Detailed descriptions yield better results for generation/lifestyle
5. Prepare images - Remove backgrounds before lifestyle shots for best results
6. Chain operations - Remove BG → Upscale → Lifestyle for complete product workflows

REST API Reference

Base URL: https://www.sirv.studio/api/zapier

All requests require: Authorization: Bearer sk_live_YOUR_API_KEY

Endpoints

Account

GET /me

Returns: {id, email, credits, tier} Cost: FREE

Background Removal

POST /remove-bg
Content-Type: application/json

{
  "image_url": "https://example.com/product.jpg",
  "model": "birefnet"
}

Returns: {id, image_url, credits_used} Cost: 1-2 credits

Models: birefnet (default), bria

Image Upscaling

POST /upscale
Content-Type: application/json

{
  "image_url": "https://example.com/image.jpg",
  "scale": 4,
  "model": "clarity"
}

Returns: {id, image_url, credits_used} Cost: 1-8 credits

Models: esrgan (fast), clarity (AI-enhanced), topaz (premium) Scale: 2, 3, or 4

Background Replacement

POST /replace-bg
Content-Type: application/json

{
  "image_url": "https://example.com/product.jpg",
  "prompt": "Modern kitchen counter with marble surface",
  "model": "flux-kontext"
}

Cost: 3-15 credits

Models: bria, flux-kontext, nano-banana

Image-to-Image Transformation

POST /image-to-image
Content-Type: application/json

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "Transform to watercolor painting style",
  "strength": 0.7
}

Cost: 1-8 credits

Strength: 0-1 (how much to transform)

Image Generation

POST /generate
Content-Type: application/json

{
  "prompt": "Professional product photo of wireless headphones",
  "model": "flux-kontext",
  "aspect_ratio": "1:1"
}

Returns: {id, image_url, credits_used} Cost: 1-10 credits

Models: flux-kontext, nano-banana, ideogram, zimage, gemini, seedream Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9

Video Generation

POST /video-generation
Content-Type: application/json

{
  "prompt": "Product rotating on display stand",
  "image_url": "https://example.com/product.jpg",
  "model": "ltx",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Cost: 10-80 credits

Models: veo31, ltx, kling, sora

3D Model Generation

POST /image-to-3d
Content-Type: application/json

{
  "image_url": "https://example.com/product.jpg",
  "model": "meshy",
  "topology": "quad",
  "enable_pbr": true
}

Returns: Multiple formats (glb, obj, fbx, usdz) Cost: 2-50 credits

Alt Text Generation

POST /alt-text
Content-Type: application/json

{
  "image_url": "https://example.com/image.jpg"
}

Cost: 1 credit

File Upload

POST /upload
Content-Type: multipart/form-data

file: [binary data, max 10MB]

Cost: FREE

Batch Operations

POST /batch/remove-bg
POST /batch/upscale
POST /batch/alt-text
Content-Type: application/json

{
  "images": [
    {"id": "1", "image_url": "https://example.com/img1.jpg"},
    {"id": "2", "image_url": "https://example.com/img2.jpg"}
  ],
  "model": "birefnet"
}

Check batch status:

GET /batch/status/{jobId}

Rate Limits

Code Examples

JavaScript

const SIRV_API = 'https://www.sirv.studio/api/zapier';
const API_KEY = 'sk_live_YOUR_API_KEY';

async function removeBackground(imageUrl) {
  const response = await fetch(`${SIRV_API}/remove-bg`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      image_url: imageUrl,
      model: 'birefnet'
    })
  });
  return (await response.json()).image_url;
}

async function generateImage(prompt, aspectRatio = '1:1') {
  const response = await fetch(`${SIRV_API}/generate`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      prompt,
      model: 'flux-kontext',
      aspect_ratio: aspectRatio
    })
  });
  return (await response.json()).image_url;
}

cURL

# Remove background
curl -X POST https://www.sirv.studio/api/zapier/remove-bg \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/product.jpg", "model": "birefnet"}'

# Generate image
curl -X POST https://www.sirv.studio/api/zapier/generate \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Product photo of headphones", "model": "flux-kontext", "aspect_ratio": "1:1"}'

# Check credits
curl https://www.sirv.studio/api/zapier/me \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"