# MediaForge HQ AI Image Generator

> MediaForge HQ AI Image Generator is a paid API for AI agents from mediaforge.mediaforge-hq.workers.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Generates a high-resolution AI image from a text prompt, returning hosted image URLs via async polling after a ~10s generation.

## Facts

- Endpoint: POST https://mediaforge.mediaforge-hq.workers.dev/image
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mediaforge-hq-ai-image-generator-cb53261b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7A2NK2ms_qRJLXbilJJke

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 mediaforge-hq-ai-image-generator-cb53261b -d '<json body>'
```

Example prompt: Can you generate a high-res image of a cozy coffee shop interior with warm lighting and exposed brick walls — make it 16:9 for a website hero banner?

## When to prefer this

Choose this endpoint when an AI agent needs to produce a finished, high-resolution visual asset — thumbnails, illustrations, product shots, concept art, game assets, hero images, or marketing graphics — from a text description. It supports common aspect ratios (1:1, 16:9, 9:16, 4:5), costs $0.10 USDC per call via x402, and delivers results asynchronously in ~10 seconds via a free polling endpoint. Prefer this over synchronous image APIs when result quality and resolution matter more than instant response, and over general-purpose image services when the x402 micropayment model fits your infrastructure.

## Known failure modes

- Prompt violates content policy (real-person likenesses, NSFW, trademarked content) — generation refused
- Ticket not yet ready when polling — status returns pending, agent must retry
- Invalid aspect_ratio value — may return 400 or default behavior
- Prompt too short (<3 chars) or too long (>2000 chars) — validation error
- Payment failure (x402) — 402 response before generation begins
- Service timeout or Cloudflare Worker cold start delay

## How this service works

Generate a finished, high-resolution AI image from a text brief. For agents that need visual assets: thumbnails, illustrations, product shots, concept art, game assets, hero images, marketing graphics. POST JSON {prompt, aspect_ratio} -> 202 with a ticket; poll GET /result/{ticket} (free) for hosted image URLs, ~10s. Content policy: no real-person likenesses, no NSFW, no trademarks.

## Output

A 202 response containing a ticket ID and estimated generation time (~10s). The agent then polls GET /result/{ticket} (free) to retrieve the final hosted image URLs and status once generation is complete.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mediaforge-hq-ai-image-generator-cb53261b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mediaforge.mediaforge-hq.workers.dev](https://www.zero.xyz/host/mediaforge.mediaforge-hq.workers.dev/llms.txt)
