# Suede AI Image Generator

> Suede AI Image Generator is a paid API for AI agents from app.suedeai.ai, paid per call via x402, $0.15/call, status healthy (last checked 2026-10-12).

Generates a single still image (cover art, promo art, or standalone visual) from a text prompt, returning a creator-owned image with provenance fingerprint.

## Facts

- Endpoint: POST https://app.suedeai.ai/agent/image?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suede-ai-image-generator-f4b6f249
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mITmIhoLIVaKFufYQOF3H

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 suede-ai-image-generator-f4b6f249 -d '<json body>'
```

Example prompt: Generate cover art for my new single — a moody neon cityscape at night with a lone figure, square format (1:1), output as PNG.

## When to prefer this

Use this endpoint when you need a single still image — cover art, promo artwork, or a standalone campaign visual — with creator-owned provenance. Prefer this over general image generators when IP ownership and a provenance fingerprint are required. Choose the async mode for longer renders. Use sibling endpoints on app.suedeai.ai for full song generation or music-video clip generation instead.

## Known failure modes

- Invalid or empty prompt returns 400 bad request
- Unsupported aspect ratio or output format enum value returns 422 validation error
- Payment not received or invalid payment signature returns 402 Payment Required
- Async job not yet complete returns status 'pending' on poll — agent must retry
- Job ID not found on poll returns 404
- Rate limit or overload returns 429 or 503

## How this service works

AI image generation from a text prompt. Generate album and single cover art, podcast and video thumbnails, social and campaign graphics, concept art, storyboard frames, product shots, and article illustrations. Returns one hosted still image as PNG or JPEG in square, portrait, or widescreen framing (1:1, 4:5, 9:16, 16:9, 21:9). Async by default: poll the returned pollUrl for imageUrl, or pass ?async=false to block.

## Output

Returns an imageId, imageUrl (CDN link to the rendered image), assetUrl, a shareUrl for social sharing, and a provenance fingerprint (on-chain hash). For async calls, returns a jobId and pollUrl instead; the agent polls GET /agent/image/{jobId} until status is 'completed' and imageUrl is populated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "description": "Visual prompt describing the image to generate."
  },
  "aspectRatio": {
   "enum": [
    "1:1",
    "9:16",
    "16:9",
    "3:4",
    "4:3",
    "3:2",
    "2:3",
    "5:4",
    "4:5",
    "21:9"
   ],
   "type": "string",
   "description": "Desired frame aspect ratio."
  },
  "outputFormat": {
   "enum": [
    "png",
    "jpeg"
   ],
   "type": "string",
   "description": "Output image format."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "jobId": "image-job-example",
 "status": "queued",
 "pollUrl": "https://app.suedeai.ai/agent/image/image-job-example",
 "provider": "suede"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suede-ai-image-generator-f4b6f249/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.suedeai.ai](https://www.zero.xyz/host/app.suedeai.ai/llms.txt)