# Forest Containers – OCI Image Size Inspector

> Forest Containers – OCI Image Size Inspector is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-02).

Returns manifest-declared OCI config metadata and individual layer sizes for a public container image before pulling it.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/container/size?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-containers-oci-image-size-inspector-0615fde0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JHjw0x-Wdpl3GkkaYDA8P

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 forest-containers-oci-image-size-inspector-0615fde0 -d '<json body>'
```

Example prompt: Before I pull it, can you check the manifest-declared layer sizes and OCI config for the public image library/nginx with the latest tag?

## When to prefer this

Use this endpoint when you need to know a container image's declared layer sizes and OCI config metadata before committing to a pull, especially in bandwidth-constrained or storage-limited environments. Prefer it over actually pulling the image when the goal is pre-flight size inspection, CI/CD gating on image weight, or comparing base image options. Not suitable for vulnerability scanning, compressed download size estimation, or private registry access.

## Known failure modes

- Image repository path does not match expected pattern — returns validation error
- Reference (tag/branch) not found in registry — returns 404-equivalent error
- Registry is private or rate-limits unauthenticated access — returns access denied or timeout
- Malformed image string with uppercase characters or invalid registry format — rejected by schema pattern
- Registry returns an unexpected manifest format — partial or empty layer list returned

## How this service works

Return manifest-declared OCI config and layer sizes before an agent pulls an image. Values are registry declarations, not a compressed download or vulnerability measurement. Base mainnet USDC

## Output

Returns the manifest-declared OCI image configuration (architecture, OS, entrypoint, env vars) and the size in bytes of each layer as listed in the registry manifest. These are registry-declared values, not compressed download sizes or vulnerability scan results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "image": {
   "type": "string",
   "pattern": "^[a-z0-9][a-z0-9._-]*(?::\\d+)?(?:/[a-z0-9._-]+)+$",
   "maxLength": 512,
   "description": "Public registry image repository to inspect."
  },
  "reference": {
   "type": "string",
   "maxLength": 256,
   "minLength": 1,
   "description": "Repository branch whose current state should be checked."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-containers-oci-image-size-inspector-0615fde0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)