Yousto StoreCleanProductShot Developer APIREST API & SDK
Open ProductPhotos Web App →
VISION & COMPOSITING

CleanProductShot API.

Convert cluttered product photos into pure RGB 255 white 2000x2000 Amazon-compliant assets in under 10 seconds.

$9/mo
Billed monthly with Polar MoR

Looking for the visual photo editor studio?

Use our first-party Product Photos Web App to upload single or batch photos with live sliders.

Launch Web App

Drop-In Integration Stage

OpenAPI 3.1 & Gateway Compatible
14.38ms p95
import httpx

with open("product_raw.jpg", "rb") as f:
    response = httpx.post(
        "https://api.youstostore.com/v1/images/process",
        headers={"X-API-Key": "yp_live_your_key"},
        files={"file": ("product_raw.jpg", f, "image/jpeg")},
        data={
            "preset": "amazon_main",
            "add_shadow": "true",
            "canvas_size": 2000,
            "fill_percentage": 86.0
        }
    )

result = response.json()
print(result["compliance"]["perimeter_compliant"]) # True (100% RGB 255)
print(result["jpeg_download_url"])                 # 2000x2000 deliverable
ARCHITECTURE & VALUE PROPOSITION

Marketplace-compliant product photos in under 10 seconds

CleanProductShot converts raw, cluttered product photos into marketplace-ready e-commerce assets with guaranteed pure RGB (255, 255, 255) white backgrounds, Amazon 85% frame-fill auto-centering, natural contact shadows, and standardized sRGB color profiles.

The Problem

Engineering Pain & Fragility

E-commerce sellers face algorithmic listing suppression or rejection on Amazon, Walmart, and Google Shopping when product main images fail strict background compliance rules (pure #FFFFFF white, 85% frame fill, proper color profiles). Professional studio photography costs $25-$50 per photo and takes days.

The Solution

What the API Solves

Upload any raw product photo (JPG, PNG, WEBP, or Apple HEIC) and receive high-resolution marketplace-ready deliverables (2000x2000 JPEG and transparent PNG). The vision engine performs de-fringing, proportional 85% bounding box scaling, baseline grounding, and perimeter RGB 255 verification in under 10 seconds.

EXECUTION PIPELINE

How it works. Step by step.

01

Drop raw product photos.

Upload smartphone or camera photos in any lighting — clutter, room backgrounds, and Apple HEIC supported.

02

Segment & clamp.

Local ONNX segmentation isolates the subject, scales it to 85% fill with baseline grounding, and clamps 100% of border pixels to RGB (255, 255, 255).

03

Download marketplace deliverables.

Receive 2000x2000 pure white compliance JPEGs and transparent cutout PNGs with embedded sRGB ICC color profiles.

PRODUCTION GUARANTEES

Built for enterprise production standards.

Pure RGB (255, 255, 255) Clamping

100% of the outer 20-pixel perimeter band is programmatically verified pure white.

Amazon 85% Auto-Centering

Subject scales strictly between 84.0% and 88.0% of the 2000px canvas with optical baseline grounding.

Contact Shadow Synthesis

Synthesizes realistic grounded drop shadows from product baseline contact masks.

Standardized sRGB Color Profile

Injects sRGB IEC61966-2.1 ICC profile to prevent color shifts on mobile app webviews.

Under 10 Seconds

Blazing fast local vision engine execution without paid third-party API dependencies.

24h Auto-Purge Privacy

All uploaded photos and deliverables are automatically purged after 24 hours.

TARGET WORKFLOWS

Ideal use cases & engineering workflows.

Amazon FBA and FBM sellers optimizing main product listings. Walmart Marketplace merchants meeting white background standards. Shopify and WooCommerce store owners standardizing product catalogs. E-commerce agencies processing high-volume inventory photos. Photographers batch-cleaning studio assets.

DEVELOPER SPECIFICATIONS

Interactive OpenAPI 3.1 Contract & Schemas.

Inspect request/response payload schemas, test custom JSON parameters, view error handling codes, or download the full OpenAPI 3.1 specification for your automated SDK generators.

OpenAPI 3.1.0 ContractSub-12ms p95
POSThttps://api.youstostore.com/v1/semantic-cache

Sub-15ms semantic & exact similarity matching for LLM completions

Request Body Properties (JSON)

querystringRequired

The user prompt or natural language query to evaluate for semantic similarity.

example: "How do I initiate a return or refund for my order?"
thresholdnumberOptionaldefault: 0.92

Minimum cosine similarity score (0.80 to 0.99) required to consider a cache hit.

example: 0.92
modelstringOptionaldefault: "gpt-4o"

Underlying target model for token cost and token count calculation.

example: "gpt-4o"
ttl_secondsintegerOptionaldefault: 86400

Time-to-live for cached entries in seconds (up to 2,592,000 for 30 days).

example: 86400

Response Body (200 OK)

application/json
{
  "cache_hit": true,
  "similarity_score": 0.962,
  "threshold": 0.92,
  "matched_entry": {
    "id": "cached_sem_892a01",
    "original_query": "How do I initiate a return or refund for my order?",
    "response": "You can request a return within 30 days of purchase via your account order history."
  },
  "response": "You can request a return within 30 days of purchase via your account order history.",
  "metrics": {
    "tokens_saved": 187,
    "cost_saved_usd": 0.00281,
    "p95_latency_ms": 6.8,
    "tier": "growth"
  }
}
WHO NEEDS THIS

Real people, real problems this solves.

👤

Amazon FBA Seller

Problem: Listing suppressed due to off-white background and poor frame fill.

Runs raw smartphone photos through CleanProductShot and uploads compliant 2000x2000 images in 10 seconds.

👤

Shopify Brand Founder

Problem: Catalog photos have inconsistent backgrounds and lighting.

Standardizes entire product catalog with pure white backgrounds and natural contact shadows.

👤

E-Commerce Agency

Problem: Spends hours manually clipping backgrounds for hundreds of client SKU photos.

Uses the batch processing API to clean 50+ photos simultaneously.

PRICING

Choose the right plan for your workload.

All plans include full API access, automated EU VAT invoicing via Polar.sh Merchant of Record, and instant API key generation on checkout.

ONE-TIME

Starter Pack

25 high-res photos
$9/month
25 High-Res 2000x2000 JPEGs
Transparent PNG Cutouts included
Amazon 85% Auto-Centering
Pure White RGB(255,255,255) Guarantee
Instant Web & API Access
RECOMMENDED

Solo Seller

200 photos / month
$29/month
200 High-Res Photos / month
Batch Upload & Processing (up to 100/batch)
Natural Contact Shadow Synthesis
Commercial API Key (100 req/min)
Sub-10s Processing Speed
Auto-purge 24h Data Privacy
SCALE

Brand & Agency

800 photos / month + Team API
$79/month
800 High-Res Photos / month
High-Concurrency Celery Workers
Dedicated Webhook Callbacks
Team API Keys & OpenAPI Integration
Custom Padding & Baseline Controls
Priority Support from Yousto Specialists
CleanProductShot.
$9/month · Starter Pack · monthly
Polar.sh MoR + EU VAT
Instant API Key
ECONOMIC DECISION

Why buy instead of building internally?

Prevents costly Amazon listing suppression and doubles click-through rates with clean studio-grade presentation. Saves hundreds of dollars compared to manual Photoshop clipping or studio re-shoots.

Zero recurring maintenance tax
Sub-15ms edge caching & validation
Tenant-scoped cryptographic isolation
INFRASTRUCTURE HARDENING

Security, privacy and operational integrity.

Auth SchemeSHA-256 Digest API Keys
IsolationTenant-scoped Namespaces
ObservabilityPrometheus & X-Request-ID

Photos are processed locally in private container memory and purged from cloud storage after 24 hours. No external vision APIs inspect your proprietary product prototypes.

Transparent Disclosure

Architectural Scope & Production Boundaries

Optimized for physical commercial products (electronics, cosmetics, fashion, footwear, packaged goods). Does not support video processing.
FREQUENTLY ASKED QUESTIONS

Questions & answers for engineering leads.

Yes. Amazon strictly requires a pure white background (RGB 255, 255, 255) and that the product occupies at least 85% of the frame. CleanProductShot programmatically verifies 100% compliance across both rules.

READY FOR PRODUCTION

Deploy CleanProductShot in minutes.

Start with our developer tier on Polar.sh Merchant of Record. Automated EU VAT invoices, instant API key generation, and 99.99% edge uptime SLA.