Validation Error

HTTP Status: 400

{
  "code": "validation_error",
  "message": "One or more parameters are invalid",
  "details": "Invalid value for 'format'. Expected: png, jpg, webp",
  "request_id": "req_abc123"
}

Reasons and How to Fix

Invalid Parameter Value

A parameter has an invalid value that doesn’t match the expected options. Common issues:

format must be one of: png, jpg, webp
channels must be one of: rgba, rgb, alpha
size must be one of: full, preview, medium, hd
crop must be a boolean (true/false) or an aspect ratio like 1:1, 4:3, 16:9
padding must be a number (0.1) or percentage (10%)

Incorrect Data Types

Parameters must be the correct type.

# ❌ Wrong - crop should be boolean, not string
-F "crop=yes"

# ✅ Correct
-F "crop=true"

Missing Required Parameters

The image_file parameter is required for the /remove endpoint.

# ❌ Wrong - missing image
curl -X POST https://api.poof.bg/v1/remove -H "x-api-key: KEY"

# ✅ Correct
curl -X POST https://api.poof.bg/v1/remove \
  -H "x-api-key: KEY" \
  -F "image_file=@photo.jpg"

Valid Parameter Reference

Parameter	Type	Valid Values
`image_file`	file	Required. Max 20MB
`format`	string	`png`, `jpg`, `webp`
`channels`	string	`rgba`, `rgb`, `alpha`
`bg_color`	string	Hex, RGB, or color name
`size`	string	`full`, `preview`, `medium`, `hd`
`crop`	boolean or string	`true`, `false`, or aspect ratio like `1:1`
`padding`	string	Number (`0.1`) or percentage (`10%`), with `crop`

Getting Started

API Reference

Validation Error

Reasons and How to Fix

Invalid Parameter Value

Incorrect Data Types

Missing Required Parameters

Valid Parameter Reference

Need Help?

​Reasons and How to Fix

​Invalid Parameter Value

​Incorrect Data Types

​Missing Required Parameters

​Valid Parameter Reference

​Need Help?

Reasons and How to Fix

Invalid Parameter Value

Incorrect Data Types

Missing Required Parameters

Valid Parameter Reference

Need Help?