$ man image-convert
/image-convert(1)
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
media
STATUS
● live
NAME
image-convert — universal image format converter (png, jpg, webp, avif, gif, bmp, tiff, ico, heic, heif, psd, svg)
SYNOPSIS
POST https://x402.org/v1/image-convert
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Universal image format converter (PNG, JPG, WEBP, AVIF, GIF, BMP, TIFF, ICO, HEIC, HEIF, PSD, SVG). Optional resize + quality. CloudConvert engine.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| image_url | string | URL of source image. Format inferred from extension. | required |
| output_format | string | Target format: png, jpg, webp, avif, gif, bmp, tiff, ico, heic, heif, psd. | required |
| quality | number | 1-100. Affects jpg/webp/avif. | optional |
| width | number | Optional resize width (1-16000). | optional |
| height | number | Optional resize height (1-16000). | optional |
| fit | string | 'max' (default), 'crop', or 'scale' when resizing. enum: max · crop · scale | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| image_url | string | URL to the converted image file hosted on CloudConvert's CDN, ready for download. |
| file_size_bytes | number | Size of the converted output image in bytes. |
| input_format | string | Detected format of the source image (png, jpg, webp, avif, heic, etc.). |
| output_format | string | Target format the image was converted to (png, jpg, webp, avif, gif, bmp, tiff, ico, heic, heif, psd, svg). |
| source_url | string | Original URL of the source image that was fetched and converted. |
| job_id | string | CloudConvert job identifier for the conversion task, useful for debugging or support. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/image-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-convert tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- imageconvertpngjpgwebpavifheicformat
- env
- CLOUD_CONVERT_API_KEY
- 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-format-convert | Image converter. | $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