# Echo Router Image Generation

> Echo Router Image Generation is a paid API for AI agents from echo.router.merit.systems, paid per call via x402, $0.312838/call, status unknown (last checked 2026-09-15).

Generates images from text prompts using OpenAI's image generation models with configurable size, quality, and count parameters.

## Facts

- Endpoint: POST https://echo.router.merit.systems/images/generations
- Price: $0.312838/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Success rate: 0% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/echo-router-image-generation-b4d89389
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rAj3i9y-ABNOoZ9CFLA4d

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 echo-router-image-generation-b4d89389 -d '<json body>'
```

Example prompt: Generate a photorealistic image of a red fox sitting in a snowy forest at dusk, 1024x1024 size, using the dall-e-3 model, and give me the URL.

## When to prefer this

Prefer this endpoint when you need to generate images from natural language descriptions via OpenAI's models (e.g. DALL-E 3) and want a pay-per-call model without managing OpenAI API keys directly. Ideal for agents that need on-demand image creation within a broader multi-capability routing system (Echo Router also offers web search, code execution, and LLM responses).

## Known failure modes

- Invalid or missing prompt returns a 400 error
- Unsupported model name results in an error response
- Invalid size string (not matching supported dimensions) returns an error
- Request count n exceeding model limits returns an error
- Content policy violation on the prompt causes the request to be rejected
- Payment failure or insufficient USDC balance prevents the call from proceeding

## How this service works

Creates images using OpenAI's image generation models. Supports text-to-image generation with customizable size, quality, and style parameters.

## Output

Returns an array of generated image objects (at least one), each containing either a URL linking to the generated image or a base64-encoded JSON string of the image data, along with a Unix timestamp of when the images were created.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "integer"
  },
  "size": {
   "enum": [
    "256x256",
    "512x512",
    "1024x1024"
   ],
   "type": "string"
  },
  "user": {
   "type": "string"
  },
  "model": {
   "enum": [
    "gpt-image-1"
   ],
   "type": "string"
  },
  "prompt": {
   "type": "string"
  },
  "response_format": {
   "enum": [
    "url",
    "b64_json"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "data": {
  "type": "array",
  "items": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "object",
     "required": [
      "b64_json"
     ],
     "properties": {
      "b64_json": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": false
    }
   ]
  },
  "minItems": 1
 },
 "created": {
  "type": "integer",
  "maximum": 9007199254740991,
  "minimum": -9007199254740991
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/echo-router-image-generation-b4d89389/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from echo.router.merit.systems](https://www.zero.xyz/host/echo.router.merit.systems/llms.txt)