Print Ready API

Process DTF Artwork Programmatically

The DTFWiz Print Ready API gives your app the same artwork scanning and fixing capabilities used by thousands of DTF printers — via a simple REST API.

Get your API key Try in the editor

Authentication

All API requests require an API key passed in the x-api-key header. Keys are tied to your DTFWiz account and count toward your daily limit.

// Pass your key as a request header x-api-key: dtf_your_key_here // Or as a Bearer token Authorization: Bearer dtf_your_key_here

Base URL: https://dtfwiz.com/api/v1 · All endpoints accept multipart/form-data

Rate Limits

Free

100 requests / day

Pro

Higher limits

Business

Custom limits

Limits reset every 24 hours. Need higher limits? Contact us.

Error Responses

401Missing or invalid API key

429Daily limit reached — resets every 24 hours

400Bad request — missing required fields or invalid values

413Image too large — see per-endpoint size limits

500Server error — try again or contact support

// Error response shape { "error": "Daily limit reached (100 requests/day). Resets every 24 hours." }

Endpoints

POST

Scan Artwork

/api/v1/scan

Analyze a DTF artwork file and get a detailed JSON quality report. Detects DPI, background type, alpha fringe, speck noise, edge quality, and more.

Parameters

imageFilerequiredPNG, JPEG, or WebP file

print_width_inchesnumberoptionalTarget print width in inches (default: 12)

Returns:JSON — { dpi, background, alpha, ink_coverage_percent, speck_count, is_jpeg, edge_quality, issues[], suggestions[] }

Example

curl -X POST https://dtfwiz.com/api/v1/scan \
  -H "x-api-key: dtf_your_key_here" \
  -F "image=@artwork.png" \
  -F "print_width_inches=12"

POST

Fix Artwork

/api/v1/fix

Apply one or more fixes to a DTF artwork file. Remove edge fringe, trim transparent borders, remove noise specks, and resize — all in one call. Returns a clean PNG.

Parameters

imageFilerequiredPNG, JPEG, or WebP file

fix_alpha_thresholdbooleanoptional"true" to cut semi-transparent edge fringe

alpha_thresholdnumberoptionalAlpha cutoff 0–255 (default: 144). Lower = more aggressive.

fix_trimbooleanoptional"true" to trim transparent border pixels

fix_despecklebooleanoptional"true" to remove isolated noise pixels

resize_width_pxnumberoptionalResize output to this pixel width (maintains aspect ratio)

resize_height_pxnumberoptionalResize output to this pixel height (use both for exact dimensions)

Returns:Binary PNG image (Content-Type: image/png)

Example

curl -X POST https://dtfwiz.com/api/v1/fix \
  -H "x-api-key: dtf_your_key_here" \
  -F "image=@artwork.png" \
  -F "fix_alpha_threshold=true" \
  -F "fix_trim=true" \
  -F "fix_despeckle=true" \
  -o fixed.png

POST

Remove Background

/api/v1/remove-bg

AI-powered background removal using PhotoRoom. Returns a clean PNG with transparent background. Works on complex artwork, logos, and photos. Typical response: 3–5 seconds.

Parameters

imageFilerequiredPNG or JPEG file (max 25MP)

Returns:Binary PNG image with transparent background (Content-Type: image/png)

Example

curl -X POST https://dtfwiz.com/api/v1/remove-bg \
  -H "x-api-key: dtf_your_key_here" \
  -F "image=@photo.jpg" \
  -o transparent.png

POST

AI Upscale

/api/v1/upscale

Upscale low-resolution artwork by 2× or 4× using Real-ESRGAN. Recovers fine detail lost in compression or small source files. Returns a URL to the upscaled image.

Parameters

imageFilerequiredPNG or JPEG file (max ~2MP before upscale)

scalenumberoptional2 or 4 (default: 4)

Returns:JSON — { output_url: string, scale: number }

Example

curl -X POST https://dtfwiz.com/api/v1/upscale \
  -H "x-api-key: dtf_your_key_here" \
  -F "image=@low_res.png" \
  -F "scale=4"

Ready to integrate?

Create a free API key to start scanning and fixing DTF artwork in your own app. Free plan includes 100 requests per day.

Get your free API key