Remove Background

POST

/photoroom/v1/segment

🛠️ API Function

This API is used to process image files and generate processed images in the specified format and specification.

It supports functions such as image format conversion, size adjustment, cropping, and background color removal setting.

The request body is submitted in multipart/form-data encoding format.

✅ Image Size Option Selection Guide

Size Option	Pixel Magnitude	Core Features	Application Scenarios
🎴 preview	0.25 megapixels	🚀 Smallest size & fastest loading 📉 Lowest image quality	1. Thumbnails for mobile list pages (e.g., album previews, product lists) 2. Preview images returned by the API (quickly display processing effects and reduce bandwidth consumption) 3. Placeholder images for low-traffic scenarios
🖼️ medium	1.5 megapixels	⚖️ Moderate size & balanced image quality	1. Main images for mobile detail pages (e.g., news illustrations, regular product details) 2. Regular illustrations for social platforms (Moments, forum posts) 3. Lightweight image display for mini-programs (balancing loading speed and visual effects)
💎 hd	4 megapixels	✨ Clear image quality, close to HD standard	1. HD detail images for mobile/PC terminals (e.g., e-commerce product detail images, photography work display) 2. Digital version display of online posters and leaflets 3. Scenarios requiring high image quality without ultra-large size (e.g., illustrations for online education courseware)
🎯 full	36 megapixels	📸 Lossless image quality & rich details ⏳ Largest size & slowest processing	1. Professional-grade image output (e.g., printing of photography works, export of design materials) 2. Poster display on HD large screens (e.g., offline projection screens, advertising large screens) 3. Original image backup for secondary editing (preserve complete details for subsequent cropping and enlargement)

Pricing: 0.022 PTC per request

Request

Query Params

Header Params

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/photoroom/v1/segment?response_format=url' \
--header 'Authorization: Bearer ' \
--form 'image_file=@""' \
--form 'format="png"' \
--form 'channels="rgba"' \
--form 'bg_color="red"' \
--form 'size="full"' \
--form 'crop="false"' \
--form 'despill="false"'

Responses

🟢200success

application/json

Body

Example

{
    "url": "https://file.302.ai/gpt/imgs/20260113/1876b9f3347b4901ba9b897f117dd04b.jpg"
}

🟠400

🟠402

Modified at 2026-01-14 05:32:20

wavespeed-ai/image-captioner

Explanation