$ man image-format-convert
/image-format-convert(1)
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
uncategorized
STATUS
● live
NAME
image-format-convert — image converter
SYNOPSIS
POST https://x402.org/v1/image-format-convert
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Image converter. Convert any image between PNG, JPG, WEBP, AVIF, GIF, BMP, TIFF, ICO, HEIC, HEIF, PSD, and SVG. Optional resize and quality. CloudConvert engine. Same backend as image-convert under a more search-friendly slug.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| image_url | string | HTTPS URL of the source image to convert; CloudConvert fetches it directly. | required |
| output_format | string | Target format: png, jpg, webp, avif, gif, bmp, tiff, ico, heic, heif, psd, or svg. | required |
| quality | number | Encoder quality 1-100 for lossy outputs (jpg/webp/avif); ignored for lossless formats. | optional |
| width | number | Optional target width in pixels; pair with height or omit to preserve aspect ratio. | optional |
| height | number | Optional target height in pixels; pair with width or omit to preserve aspect ratio. | optional |
| fit | string | Resize mode when width/height are set: contain, cover, fill, inside, or outside. enum: max · crop · scale | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| image_url | string | Temporary CloudConvert download URL for the converted image; fetch promptly before it expires. |
| output_format | string | Format of the returned file, echoing the requested output_format. |
| file_size_bytes | string | Size of the converted file in bytes, as a string. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/image-format-convert \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the image-format-convert tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- mediakitimage-conversionformat-converterpng-to-jpgwebpavifheicimage-resize
- methods
- POST
- cluster
- mediakit
- price
- $0.01 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| audio-transcribe | Audio transcribe / speech-to-text / Whisper-large / multi-language ASR / OpenAI Whisper API compat. | $0.01 |
| csv-to-ics | CSV calendar to ICS / iCal file generator. | $0.01 |
| image-convert | Universal image format converter (PNG, JPG, WEBP, AVIF, GIF, BMP, TIFF, ICO, HEIC, HEIF, PSD, SVG). | $0.01 |
| merge-pdf | PDF merger / combine PDFs / concatenate PDF files / join multiple PDFs into one. | $0.01 |
| pdf-merge | PDF merger / PDF combiner / PDF concatenator. | $0.01 |
| receipt-ocr | Receipt OCR. | $0.01 |
| receipt-parser | Receipt → structured JSON (vendor, address, date, line items with qty/unit_price/total, subtotal, tax, tip, total, payment method). | $0.01 |
| youtube-transcript | YouTube transcript / closed-caption fetcher / video subtitles puller / auto-generated CC reader. | $0.01 |
SEE ALSO