Convert

{
  "input": "https://example.com/photo.jpg",
  "format": "webp"
}

curl -X POST https://api.ringbee.dev/v1/image/convert \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "format=webp"

{
  "id": "job_abc123",
  "status": "pending"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

POST

image

convert

{
  "input": "https://example.com/photo.jpg",
  "format": "webp"
}

curl -X POST https://api.ringbee.dev/v1/image/convert \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "format=webp"

{
  "id": "job_abc123",
  "status": "pending"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "input": "https://example.com/photo.jpg",
  "format": "webp"
}

curl -X POST https://api.ringbee.dev/v1/image/convert \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "format=webp"

Param	Type	Description
format	string	Target format: jpeg, png, webp, avif, heic, tiff, gif
quality	integer	Output quality (1-100)

X-API-Key

string

header

required

input

string

required

Input file URL

format

string

Target format: jpeg, png, webp, avif, heic, tiff, gif

webhook_url

string

URL to receive job completion notification

Job accepted

string

Example:

"job_abc123"

status

enum<string>

Available options:

pending,

processing,

completed,

failed,

cancelled

Example:

"pending"