# Convert.Guru File Converter

> Convert.Guru File Converter is a paid API for AI agents from convert.guru, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Converts Office, Media, and CAD files from one format to another via an asynchronous job-based API

## Facts

- Endpoint: POST https://convert.guru/api/x402/v1/convert-file
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convert-guru-file-converter-9279b482
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3o0oRlmQLLwD_BxHmowQe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability convert-guru-file-converter-9279b482 -d '<json body>'
```

Example prompt: Can you convert my quarterly-report.docx file to PDF using Convert.Guru? Here's the file URL: https://example.com/quarterly-report.docx

## When to prefer this

Use this endpoint when you need to convert Office documents (DOCX, XLSX, PPTX), media files (video, audio), or CAD/technical drawings between formats in an automated agent workflow. It is well-suited for async batch scenarios where you can poll for completion. Prefer this over general file-handling tools when the input is specifically an office, media, or CAD file and you need a paid, reliable cloud conversion service with x402 micropayment support.

## Known failure modes

- Payment not settled — conversion does not start if USDC payment fails
- Invalid or unsupported file format combination — job fails with error status
- Source file URL unreachable — job fails to fetch input
- Polling status_url returns 'failed' if conversion encounters an error
- Rate limiting or server overload causing delayed processing

## How this service works

Start file conversion job

## Output

Returns a job_id, a status_url to poll, and an initial status of 'processing'. The agent must poll the status_url every few seconds until status is 'done' or 'failed'. Also returns payment confirmation details including tx_hash and settlement_status on the Base network.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "file": {
   "type": "string",
   "description": "Raw binary file content to convert. Common source formats include PDF, DOCX, XLSX, CSV, JPG/JPEG, PNG, WEBP, HEIC, TXT, HTML, MP3, WAV, MP4, AVI, MPEG, and WEBM."
  },
  "filename": {
   "type": "string",
   "description": "Original filename, e.g. document.pdf"
  },
  "created_at": {
   "type": "string",
   "description": "File creation timestamp in ISO 8601 format"
  },
  "size_bytes": {
   "type": "integer",
   "description": "File size in bytes"
  },
  "target_format": {
   "type": "string",
   "description": "Desired output format. Use for PDF to DOCX, JPG to PNG, HEIC to JPG, document conversion, image conversion, audio conversion, and video conversion. Examples: docx, pdf, xlsx, csv, png, jpg, jpeg, webp, txt, html, mp3, wav, mp4, avi, mpeg, webm."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job_id": "job_7QmN9vK2xYp4TzRb6HcD8sWfA3",
  "status": "processing",
  "message": "Conversion started. Poll status_url until status is done or failed.",
  "payment": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "payTo": "0x222c4F009c63E24cE9176C0f7f3b64E7Da0f0699",
   "amount": {
    "amount": "0.002000",
    "currency": "USDC",
    "decimals": 6,
    "atomic_units": "2000"
   },
   "job_id": "job_7QmN9vK2xYp4TzRb6HcD8sWfA3",
   "scheme": "exact",
   "network": "eip155:8453",
   "tx_hash": "0x...",
   "protocol": "x402",
   "transaction_id": "0x...",
   "settlement_status": "settled"
  },
  "status_url": "https://convert.guru/api/x402/v1/convert-file/job_7QmN9vK2xYp4TzRb6HcD8sWfA3/status",
  "retry_after_seconds": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convert-guru-file-converter-9279b482/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convert.guru](https://www.zero.xyz/host/convert.guru/llms.txt)