# x402 Paywall File Host (huntercarver24)

> x402 Paywall File Host (huntercarver24) is a paid API for AI agents from x402-paywall.huntercarver24.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Uploads a base64-encoded file (up to 10 MB) and returns a public download URL that serves the file with the specified content type for 1–168 hours.

## Facts

- Endpoint: POST https://x402-paywall.huntercarver24.workers.dev/files?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-paywall-file-host-huntercarver24-ffae3339
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7eUHzSdCitpRiuPydDNRD

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 x402-paywall-file-host-huntercarver24-ffae3339 -d '<json body>'
```

Example prompt: Host this PNG image for me for 48 hours — here's the base64 data and the content type is image/png — and give me back a public download URL I can share.

## When to prefer this

Choose this endpoint when an AI agent needs to make a file publicly accessible via a short-lived URL without setting up external storage. Ideal for passing files between services, sharing generated artifacts (PDFs, images, data files) via URL, or giving another agent a download link. Not suitable for permanent storage, executable distribution, or HTML/SVG files that must render in a browser (those are served as attachments).

## Known failure modes

- File exceeds 10 MB decoded limit — upload rejected
- Executable MIME type provided — refused with error
- Invalid base64 encoding — rejected
- TTL out of range (less than 1 or more than 168 hours) — validation error
- Payment not fulfilled — no charge and no upload
- Content type does not match MIME pattern — rejected

## How this service works

Hosts a file for an agent: upload up to 10 MB as base64 with its content type and get back a public download URL on this host that serves the bytes with that content type for 1 to 168 hours (default 24). Downloads are free, readable at once where uploaded and everywhere within about a minute. Executables are refused; HTML and SVG are served as attachments. A failed upload is not charged.

## Output

A public URL on the x402-paywall.huntercarver24.workers.dev host that serves the uploaded file bytes with the specified MIME type. The URL remains accessible for the requested TTL (1–168 hours, default 24). HTML and SVG files are served as downloadable attachments; executable file types are rejected. The charge is only applied on a successful upload.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "string",
   "description": "The file, base64 (standard or URL-safe alphabet). Up to 10485760 bytes decoded.",
   "contentEncoding": "base64"
  },
  "filename": {
   "type": "string",
   "maxLength": 128,
   "description": "Suggested download name. Never used as the storage key."
  },
  "ttlHours": {
   "type": "integer",
   "default": 24,
   "maximum": 168,
   "minimum": 1,
   "description": "Hours the download URL keeps working."
  },
  "contentType": {
   "type": "string",
   "pattern": "^[A-Za-z0-9!#$&^_.+-]+/[A-Za-z0-9!#$&^_.+-]+",
   "maxLength": 128,
   "description": "MIME type the file is served with, e.g. image/png or application/pdf. Executable types are refused; text/html and image/svg+xml are served as attachments."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-paywall-file-host-huntercarver24-ffae3339/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-paywall.huntercarver24.workers.dev](https://www.zero.xyz/host/x402-paywall.huntercarver24.workers.dev/llms.txt)