# Halowerk Image Preflight Checker

> Halowerk Image Preflight Checker is a paid API for AI agents from tools.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Validates image files (PNG, JPEG, GIF, WebP, SVG) against technical requirements by reading format, dimensions, color space, bit depth, alpha channel, ICC profile, and metadata from the file header.

## Facts

- Endpoint: POST https://tools.halowerk.com/v1/image/preflight
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-image-preflight-checker-fad7be5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_haQfY2CXxmKMTKTjHbLh3

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 halowerk-image-preflight-checker-fad7be5b -d '<json body>'
```

Example prompt: Before I upload this product JPEG to the store, check if it meets our requirements: RGB color space, no EXIF location data, at least 1000×1000 pixels, and no alpha channel — flag any issues.

## When to prefer this

Use this endpoint when you need to validate image technical properties before ingestion, upload, or publication — especially when compliance with format, color space, dimension, or metadata requirements matters. It is particularly valuable when detecting privacy risks (GPS in EXIF), print-vs-web color space mismatches (CMYK vs RGB), or platform-specific constraints. Prefer it over generic image analysis tools when you need header-level metadata extraction without full image decoding.

## Known failure modes

- Unsupported file format returns an error indicating the format is not recognized
- Corrupted or truncated file header may result in incomplete or failed parsing
- Image URL unreachable or file too large may cause a timeout or rejection
- Conflicting or missing requirement parameters may produce ambiguous validation results
- Network errors connecting to the image source return an HTTP error response

## How this service works

Liest Format, Masse, Farbraum, Bittiefe, Alphakanal, Bewegtbild, ICC-Profil und Metadaten direkt aus dem Dateikopf von PNG, JPEG, GIF, WebP und SVG. Prueft gegen selbst gesetzte Anforderungen an Groesse, Seitenverhaeltnis, Format und Metadatenfreiheit und meldet Fallstricke wie CMYK, EXIF mit Ortsangabe oder sehr grosse Pixelmengen.

## Output

A preflight report detailing the image's detected format, pixel dimensions, color space (e.g. RGB, CMYK, sRGB), bit depth, presence of alpha channel, animation/video frames, ICC profile, and embedded metadata (including EXIF). Also includes a pass/fail assessment against any provided requirements, plus warnings for problematic attributes such as CMYK color space, EXIF with geolocation data, or excessively large pixel counts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "base64": {
   "type": "string",
   "description": "Bilddatei als Base64"
  },
  "requirements": {
   "type": "object",
   "properties": {
    "formats": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "max_bytes": {
     "type": "integer"
    },
    "max_width": {
     "type": "integer"
    },
    "min_width": {
     "type": "integer"
    },
    "max_height": {
     "type": "integer"
    },
    "min_height": {
     "type": "integer"
    },
    "aspect_ratio": {
     "type": "string",
     "description": "zum Beispiel 16:9"
    },
    "aspect_tolerance": {
     "type": "number",
     "default": 0.02
    },
    "require_no_metadata": {
     "type": "boolean"
    }
   },
   "description": "Eigene Anforderungen"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-image-preflight-checker-fad7be5b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.halowerk.com](https://www.zero.xyz/host/tools.halowerk.com/llms.txt)