# image-dimensions

> image-dimensions is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns width, height, format, aspect ratio, orientation, and byte size of an image from its URL by reading at most 64 KB

## Facts

- Endpoint: GET https://intel.rallylive.ca/dev/image-size
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/image-dimensions-806ac79b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qC5s6toqOJgNKzowaLMcE

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 image-dimensions-806ac79b
```

Example prompt: What are the width, height, format, and aspect ratio of the image at https://example.com/hero.jpg?

## When to prefer this

Use this endpoint when you need to quickly inspect image metadata (dimensions, format, aspect ratio) from a URL without fully downloading the image. Ideal for validating og:image tags, thumbnail sizing rules, or upload constraints. Prefer this over a full image download approach when bandwidth and latency matter, or when you only need metadata rather than pixel data.

## Known failure modes

- URL is unreachable or returns a non-2xx status — error with HTTP status code
- URL points to a non-image resource — format undetected or error returned
- Image is served without Content-Length header — byte size may be unavailable
- SVG or unusual format may not yield pixel dimensions
- Very large images that obscure dimensions beyond 64 KB may return incomplete data

## How this service works

Image dimensions from the first bytes of an image URL: width, height, format (PNG, JPEG, GIF, WebP, BMP, ICO, SVG), aspect ratio, orientation, byte size from headers and content type. Reads at most 64 KB so it is fast even for huge images. Validate og:image sizes, thumbnails and uploads. $0.01 per image.

## Output

Returns the image's pixel width and height, file format (PNG, JPEG, GIF, WebP, BMP, ICO, or SVG), aspect ratio, orientation (portrait/landscape/square), byte size from HTTP headers, and content type — all extracted from at most the first 64 KB of the image.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/image-dimensions-806ac79b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)