Developer Documentation

ShotStudio API

Remove backgrounds from product images via API. Powered by RMBG-1.4 AI model, 10ms average response time.

Authentication Endpoints Examples Migration Guide

Quick Start

1

Get API Key

Sign up for free account and get your API key from dashboard.

Get Free API Key →
2

Make Request

Send your image to our endpoint and get results in JSON or base64.

3

Integrate

Use our SDKs for Python, Node.js, or Go for faster integration.

API Pricing Plans

Free Tier
$0/mo
  • • 100 requests/month
  • • Rate: 10 req/min
  • • Community support
Developer
$29/mo
  • • 10,000 requests/month
  • • Rate: 100 req/min
  • • Priority support
  • • Webhook support
Business
$99/mo
  • • 100,000 requests/month
  • • Rate: 500 req/min
  • • Dedicated support
  • • SLA guarantee

Authentication

Authenticate requests using your API key via Bearer token:

curl -X POST https://api.shotstudio.com/v1/remove-background
-H "Authorization: Bearer YOUR_API_KEY"
-F "image=@product.jpg"

Endpoints

POST /v1/remove-background

Remove background from a product image. Returns base64 encoded PNG or URL to processed image.

Request Body (multipart/form-data)

// Required
image (file) - Image file (JPG, PNG, WebP, max 25MB)

// Optional
format (string) - "base64" | "url" | "json"
crop (boolean) - Auto-crop to product bounds (default: true)
shadow (boolean) - Add drop shadow (default: false)
background (string) - Fill color: "white" | "transparent" | "#FFFFFF"

Response

{
  "success": true,
  "image": "data:image/png;base64,iVBORw0KGgo...",
  "processing_time_ms": 847,
  "credits_remaining": 199
}
POST /v1/batch/remove-background

Process multiple images in a single request. Ideal for bulk product image processing.

Request Body (multipart/form-data)

// Required
images[] (file[]) - Array of image files (max 20 files, 50MB total)

// Optional
webhook_url (string) - Receive results via webhook when complete

Response

{
  "batch_id": "batch_abc123",
  "status": "processing",
  "estimated_seconds": 30
}
POST /v1/crop

Crop image to platform-specific dimensions. Perfect for preparing images for Amazon, Shopify, or eBay.

Request Body

{
  "image": "base64_string_or_url",
  "platform": "amazon" | "shopify" | "ebay" | "custom",
  "product_ratio": 0.85 (0.6 - 0.95)
}

Code Examples

Python

pip install shotstudio
from shotstudio import Client

client = Client("your_api_key")

# Single image
result = client.remove_background(
  image="product.jpg",
  format="url"
)
# Batch processing
batch = client.batch_remove_background([
  "image1.jpg",
  "image2.jpg",
  "image3.jpg"
])

Node.js

npm install shotstudio
const { ShotStudio } = require('shotstudio');

const client = new ShotStudio({
  apiKey: 'your_api_key'
});

// Single image
const result = await client.removeBackground({
  image: 'product.jpg'
});

// With options
const processed = await client.removeBackground({
  image: 'product.jpg',
  shadow: true,
  background: 'white'
});

cURL

curl -X POST https://api.shotstudio.com/v1/remove-background \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@product.jpg" \
  -F "format=url" \
  -F "shadow=true"

Go

package main

import (
  "github.com/shotstudio/shotstudio-go"
)

func main() {
  client := shotstudio.NewClient("your_api_key")

  result, _ := client.RemoveBackground(&shotstudio.Request{
    Image: "product.jpg",
    Format: "url",
  })
}
🔄

Migration Guide from remove.bg

If you're currently using remove.bg's API, migrating to ShotStudio takes less than 5 minutes. Our API is designed to be a drop-in replacement.

Key Differences

Feature remove.bg ShotStudio
Model BiRefNet RMBG-1.4
Max file size 12MB 25MB
Batch API ❌ ✅
Platform crop ❌ ✅
Webhook support ❌ ✅

Migration Steps

  1. 1. Get your ShotStudio API key from the dashboard
  2. 2. Replace the base URL in your code
  3. 3. Update the Authorization header format (same format)
  4. 4. Test with your existing images
  5. 5. Update error handling if needed

Endpoint change:

remove.bg/api → api.shotstudio.com/v1
Read Full Migration Guide →

SDKs & Libraries

🐍

Python

pip install shotstudio

🟢

Node.js

npm install shotstudio

🔷

Go

go get github.com/shotstudio/shotstudio-go

💎

Ruby

gem install shotstudio

Ready to integrate?

Get your free API key and start processing images in minutes.

Get Free API Key Contact Sales

Free tier: 100 requests/month • No credit card required