Dashboard Overview

Credit Balance

0

Transforms (30d)

0

Credits Used (30d)

0

Active API Keys

0

Recent Transactions

No transactions yet

Quick Start

1

Create an API Key

Generate a key to authenticate your requests

2

Make API Requests

Use the Transform API with your key

3

Top Up Credits

Purchase credits when running low

Example API Request

curl -H "Authorization: Bearer YOUR_API_KEY" "https://dev.trimpng.com/transform/image.png?w=400"

Credits & Billing

Current Balance

0

Credit Packages

Transform Pricing

Transform	Category	Credits

API Keys

Name	Key Prefix	Status	Last Used	Actions
No API keys yet

Usage Statistics

Usage by Transform (Last 30 Days)

No usage data

Transaction History

Start Date

End Date

Type

Transform

Date	Type	Description	Amount	Balance
No transactions

Team Members

Name	Email	Role	Status	Actions
Loading...

All Companies

Company	Email	Status	Credits	Actions
Loading...

Global Transform Pricing

Transform	Category	GPU	Credits	Actions
Loading...

Credit Packages

Name	Credits	Price	Featured	Actions
Loading...

Image Sources

How Sources Work

Sources connect your image storage (like DO Spaces or S3) to TrimPNG. Each source gets a unique subdomain URL for transforms.

Example: https://your-source.trimpng.com/image.png?w=400

Name	URL	Status	Images	Storage	Bandwidth	Actions
No sources yet. Add one to get started.

Source Gallery

0

Total Images

0

Tagged

0 MB

Total Size

0

Total Requests

No images yet. Images will appear here as they're processed through your source.

System Settings

Setting	Description	Value	Actions
Loading...

Transform API Documentation

Quick Start

Transform images by adding parameters to your source URL:


https://your-source.trimpng.com/image.png?w=400&format=webp&q=80

Or test with any URL:


https://dev.trimpng.com/transform/url?url=https://example.com/photo.jpg&w=400

Resize & Crop

w number

DO Server

Width in pixels. Max 4096.

?w=400

h number

DO Server

Height in pixels. Max 4096.

?h=300

fit string

DO Server

How to fit image into dimensions.

Values: cover, contain, fill, inside, outside

?w=400&h=400&fit=cover

crop string

DO Server

Crop position when using fit=cover.

Values: center, top, bottom, left, right, attention, entropy

?w=400&h=400&fit=cover&crop=attention

dpr number

DO Server

Device pixel ratio multiplier (1-3). Multiplies w/h values.

?w=400&dpr=2 → outputs 800px

trim boolean|number

DO Server

Auto-crop transparent/whitespace borders. Number sets threshold (default 10).

?trim=true or ?trim=20

extract string

DO Server

Extract specific region: left,top,width,height

?extract=100,100,400,300

Format & Quality

format string

DO Server

Output format.

Values: webp, png, jpeg, avif, gif, tiff

?format=webp

q number

DO Server

Quality 1-100. Default 80.

?format=webp&q=90

auto string

DO Server

Auto-select best format based on browser support.

Values: format, compress

?auto=format

dpi number

DO Server

Set DPI metadata for print. 72-600.

?dpi=300

Basic Transforms

rotate number

DO Server

Rotate image.

Values: 0, 90, 180, 270

?rotate=90

flip boolean

DO Server

Flip vertically (top to bottom).

?flip=true

flop boolean

DO Server

Flop horizontally (left to right / mirror).

?flop=true

Color Adjustments

brightness number

DO Server

Brightness multiplier. 0-3, default 1.

?brightness=1.2

contrast number

DO Server

Contrast multiplier. 0-3, default 1.

?contrast=1.3

saturation number

DO Server

Saturation multiplier. 0-3, default 1. Use 0 for grayscale.

?saturation=1.5

hue number

DO Server

Hue rotation in degrees. 0-360.

?hue=180

gamma number

DO Server

Gamma correction. 1-3.

?gamma=2.2

grayscale boolean

DO Server

Convert to grayscale.

?grayscale=true

sepia boolean

DO Server

Apply sepia tone effect.

?sepia=true

tint string

DO Server

Tint with color. Hex or RGB.

?tint=ff6600 or ?tint=255,102,0

negate boolean

DO Server

Invert colors (negative).

?negate=true

normalize boolean

DO Server

Stretch contrast to full range (auto-levels).

?normalize=true

Effects

blur number

DO Server

Gaussian blur sigma. 0.3-1000.

?blur=5

sharpen number|boolean

DO Server

Sharpen image. 0.5-10 or true for default.

?sharpen=2

median number

DO Server

Median filter for noise reduction. 1-10.

?median=3

threshold number

DO Server

Convert to black/white at threshold. 0-255.

?threshold=128

posterize number

DO Server

Reduce color levels per channel. 2-256.

?posterize=4

colors number

DO Server

Reduce to N colors using color quantization. 2-256.

?colors=16

DTF / Print Processing

halftone number

DO Server

DTF halftone effect. LPI (lines per inch) 15-100. Standard is 45.

Only affects semi-transparent pixels. Solid areas stay solid.

?halftone=45

halftone_shape string

DO Server

Halftone dot shape.

Values: round, ellipse, line, square, diamond

?halftone=45&halftone_shape=round

halftone_angle number

DO Server

Screen angle in degrees. Default 22.5° (standard for screen printing).

?halftone=45&halftone_angle=22.5

alpha_threshold number

DO Server

Clean up semi-transparent pixels. 0-255. Pixels below become transparent.

?alpha_threshold=128

Watermark

watermark string

DO Server

Text watermark to overlay.

?watermark=Copyright%202024

watermark_logo string

DO Server

Storage key for logo image to use as watermark.

?watermark_logo=logos/company.png

watermark_opacity number

DO Server

Watermark opacity. 0-1, default 0.3.

?watermark=Text&watermark_opacity=0.5

watermark_tile boolean

DO Server

Tile watermark diagonally across image.

?watermark=SAMPLE&watermark_tile=true

watermark_angle number

DO Server

Rotation angle in degrees. Default -30.

?watermark=Text&watermark_angle=-45

watermark_scale number

DO Server

Logo scale percentage. Default 100.

?watermark_logo=logo.png&watermark_scale=50

Borders & Composition

border string

DO Server

Add border. Format: width,color

?border=10,ff0000

rounded number

DO Server

Round corners radius in pixels.

?rounded=20

pad string

DO Server

Add padding. Format: size or top,right,bottom,left

?pad=20 or ?pad=10,20,10,20

extend string

DO Server

Extend canvas. Format: top,right,bottom,left,color

?extend=10,10,10,10,ffffff

AI / ML Transforms

These transforms use GPU acceleration and may take longer to process.

bg string

Lambda GPU

Background removal/replacement.

Values: remove, white, blur, transparent

?bg=remove

upscale number

Lambda GPU

AI upscale image.

Values: 2, 4, 8

?upscale=4

enhance boolean

Lambda GPU

AI image enhancement (auto color/contrast/sharpness).

?enhance=true

face_restore boolean

Lambda GPU

AI face restoration for old/damaged photos.

?face_restore=true

colorize boolean

Lambda GPU

AI colorization for black & white photos.

?colorize=true

style string

Lambda GPU

AI style transfer.

Values: anime, cartoon, sketch, oil, watercolor, pencil, pop_art

?style=anime

tag boolean

Lambda GPU

AI auto-tagging using RAM model. Returns tags in response metadata.

?tag=true

denoise string

Lambda GPU

AI noise reduction.

Values: light, medium, heavy

?denoise=medium

deblur boolean

Lambda GPU

AI motion/blur removal.

?deblur=true

jpg_artifact boolean

Lambda GPU

Remove JPEG compression artifacts.

?jpg_artifact=true

hdr boolean

Lambda GPU

AI HDR effect enhancement.

?hdr=true

lowlight boolean

Lambda GPU

AI low-light image enhancement.

?lowlight=true

depth boolean

Lambda GPU

Generate depth map from image.

?depth=true

segment boolean

Lambda GPU

AI image segmentation.

?segment=true

age string|number

Lambda GPU

AI face age transformation.

Values: young, old, or number 1-100

?age=young or ?age=25

inpaint string

Lambda GPU

AI inpainting - fill masked areas. Requires mask image.

?inpaint=mask_key.png

Response Handling

Different transforms return different response types.

Synchronous (Simple Transforms)

Resize, format, quality, halftone, etc. return immediately with a 302 redirect to the image.

HTTP/1.1 302 Found
Location: https://nyc3.digitaloceanspaces.com/trim-png/transformed/...

Asynchronous (AI/ML Transforms)

Background removal, upscale, enhance, etc. return 202 Accepted with a job ID:

{
  "status": "QUEUED",
  "jobId": "db5ed95b-7403-47e7-9627-928dc976a567",
  "pollUrl": "/api/status/db5ed95b-7403-47e7-9627-928dc976a567",
  "estimatedTime": 5000
}

Polling for Status

Poll GET /api/status/{jobId} until complete:

QUEUED Job waiting in queue

PROCESSING GPU is processing

COMPLETED Done - result.url contains the image

FAILED Error - check error.message

Completed Response

{
  "jobId": "db5ed95b-7403-47e7-9627-928dc976a567",
  "status": "COMPLETED",
  "type": "REMOVE_BG",
  "completedAt": "2025-12-17T06:31:58.000Z",
  "result": {
    "url": "https://..../transformed/abc123.png",
    "mimeType": "image/png",
    "width": 800,
    "height": 600
  }
}

JavaScript Polling Example

async function waitForTransform(jobId) {
  const pollUrl = `https://trimpng.com/api/status/${jobId}`;
  
  for (let i = 0; i < 30; i++) {
    const res = await fetch(pollUrl);
    const data = await res.json();
    
    if (data.status === 'COMPLETED') {
      return data.result.url;
    }
    if (data.status === 'FAILED') {
      throw new Error(data.error?.message);
    }
    
    await new Promise(r => setTimeout(r, 2000));
  }
  throw new Error('Timeout');
}

TrimPNG

Dashboard Overview

Recent Transactions

Quick Start

Credits & Billing

Credit Packages

Transform Pricing

API Keys

Usage Statistics

Usage by Transform (Last 30 Days)

Transaction History

Team Members

All Companies

Global Transform Pricing

Credit Packages

Image Sources

How Sources Work

Source Gallery

System Settings

Transform API Documentation

Quick Start

Resize & Crop

Format & Quality

Basic Transforms

Color Adjustments

Effects

DTF / Print Processing

Watermark

Borders & Composition

AI / ML Transforms

Response Handling

Synchronous (Simple Transforms)

Asynchronous (AI/ML Transforms)

Polling for Status

Completed Response

JavaScript Polling Example

Modal Title