WithZero Pixel Art Canvas Import is a paid API for AI agents from agents.withzero.xyz, paid per call via x402 or MPP, $0.01/call (dynamic — varies by input), status healthy (last checked 2026-10-02, last successful call 2026-09-25).
Imports an image or pixel art asset into a WithZero pixel art canvas for editing or use in media creation.
Import agent-owned pixel canvases.
Returns a canvas object representing the imported pixel art, including a canvas ID and the initialized canvas state derived from the source image, ready for further editing or export operations.
POSThttps://agents.withzero.xyz/api/v1/pixelart/canvas/import?utm_source=zero.xyzChoose this endpoint when you need to bring an existing image or pixel art asset into a WithZero pixel art canvas as a starting point for editing, rather than generating new pixel art from scratch. Prefer this over generation endpoints when the user already has a source image they want to work from.
| Field | Type | Description |
|---|---|---|
| fitrequired | string | fill = stretch; contain = letterbox; cover/crop = crop to fill. Default contain. |
| fps | integer | Default playback rate for frames added after import. |
| game | object | Optional engine metadata for the imported art. |
| looprequired | boolean | Whether animation playback loops by default. |
| name | string | Canvas name. Shown in the viewer tab. |
| widthrequired | integer | Target canvas width in pixels. Default 64. |
| colors | integer | Quantize result to N distinct colors using median-cut. Omit to keep full color fidelity. |
| heightrequired | integer | Target canvas height in pixels. Default 64. |
| canvasId | string | If provided, overwrite an existing canvas instead of creating a new one. |
| imageUrl | string | Publicly accessible image URL to fetch server-side. Max 5 MB. |
| imageData | string | Base64-encoded image bytes (PNG / JPEG / WebP / GIF). Max 2 MB encoded (≈1.5 MB actual). |
| scaleModerequired | string | nearest = pixel-art-preserving (best for existing pixel art). smooth = Lanczos3 downscale (best for photos → pixel art). |
| background | array | [r, g, b, a] fill color for letterbox padding. Default transparent. |
| Field | Type | Description |
|---|---|---|
| idrequired | string | |
| widthrequired | integer | |
| apiUrlrequired | string | |
| heightrequired | integer | |
| ansiUrlrequired | string | URL that returns ANSI half-block art — pipe via `curl <ansiUrl>` to render in any terminal or agent context. |
| viewUrlrequired | string | |
| guideUrlrequired | string | Holistic agent workflow guide. |
| colorCountrequired | integer | Distinct RGBA colors in the imported result. |
| fullSpecUrlrequired | string | Complete OpenAPI surface including free editing routes. |
| manifestUrlrequired | string | Engine-ready animation manifest for this mutable canvas. |
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"