# imagcon.app Generate Image

> imagcon.app Generate Image is a paid API for AI agents from imagcon.app, paid per call via x402, $0.195/call, status unknown (last checked 2026-09-14).

AI-generates a source image from a text prompt using Vertex AI Imagen and returns a JSON response with an image key and preview URL

## Facts

- Endpoint: POST https://imagcon.app/routes/x402/generate-image
- Price: $0.195/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/imagcon-app-generate-image-43beb068
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VzIfoh-0grODHbPRJNPWy

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 imagcon-app-generate-image-43beb068 -d '<json body>'
```

Example prompt: Generate an AI image of a vibrant coffee shop interior with warm lighting and exposed brick walls — I'll use it as the source image for my app icon.

## When to prefer this

Choose this endpoint when you need to programmatically generate a brand-new image from a text description without any existing source file, especially as a first step before using imagcon.app sibling endpoints for PWA icon sets, iOS splash screens, or social media resizing. Ideal for agentic workflows that need to create visual assets from scratch with no account signup and a simple pay-per-call model via x402.

## Known failure modes

- Vague or ambiguous text prompt may produce unexpected or low-quality images
- Payment of $0.195 USDC not received or x402 payment flow fails — endpoint returns payment required error
- Vertex AI Imagen service unavailable or rate-limited — returns 5xx error
- Prompt violates content policy — returns rejection with policy violation message
- Network timeout on image generation — returns timeout error

## How this service works

Generate one image from a text prompt: app icon, brand logo, character mascot or illustration. POST JSON {description, type?, style?, aspect_ratio?}. type is icon, logo, mascot or illustration (default icon; only icon gets app-icon framing and mask safe margins). style is flat, metallic, 2d-game, clay, 3d, gradient or glassmorphism. aspect_ratio is 1:1, 4:3 or 16:9. Returns image_key and preview_url. No account required.

## Output

Returns a JSON object containing an image_key (identifier for the generated image, usable with sibling endpoints for icon set generation, splash screen creation, or resizing) and a preview_url (direct URL to view the generated image). No account or registration is required.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "icon",
    "illustration",
    "logo",
    "mascot"
   ],
   "type": "string",
   "default": "icon",
   "description": "What to produce. Only 'icon' applies app-icon framing and OS-mask safe margins."
  },
  "style": {
   "enum": [
    "2d-game",
    "3d",
    "clay",
    "flat",
    "glassmorphism",
    "gradient",
    "metallic"
   ],
   "type": "string",
   "description": "Optional visual finish."
  },
  "description": {
   "type": "string",
   "description": "Text description of the image to generate"
  },
  "aspect_ratio": {
   "enum": [
    "1:1",
    "4:3",
    "16:9"
   ],
   "type": "string",
   "default": "1:1",
   "description": "Output shape. 16:9 suits OG and hero images."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/imagcon-app-generate-image-43beb068/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from imagcon.app](https://www.zero.xyz/host/imagcon.app/llms.txt)
