# x402-gateway OG Image Generator

> x402-gateway OG Image Generator is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Generates a 1200x630 Open Graph social-card PNG image from a title and description, returned as a base64-encoded image.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/og_image_generator
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-og-image-generator-aa795509
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ANPjgSo8nCBvGbFQ3wFPM

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 x402-gateway-og-image-generator-aa795509 -d '<json body>'
```

Example prompt: Generate an Open Graph social card image (1200x630 PNG) for my article titled 'How AI is Changing Content Marketing' with the description 'AI tools are transforming how brands create, distribute, and optimize content at scale.' and include this header graphic: https://example.com/header.png

## When to prefer this

Choose this endpoint when you need a programmatically generated Open Graph social preview image (1200x630 PNG) on demand from structured text inputs, especially in agentic or automated publishing workflows where paying $0.001 USDC per image is acceptable. Prefer it over manual design tools when speed, automation, and MCP-native base64 image output are priorities.

## Known failure modes

- Title or description exceeding character limits may be silently truncated
- Invalid or unreachable header image URL may cause generation failure or omit the header graphic
- Malformed POST body or missing required fields returns an error
- Payment not included or insufficient USDC balance causes a 402 Payment Required response
- Service unavailability returns a 5xx error

## How this service works

x402-gateway tool: og_image_generator — Generate an Open Graph social-card image (1200x630 PNG) from a title and description. Returns a base64-encoded image (MCP content type image). Optional image URL embeds a header graphic. Title truncated to 60 chars, description to 120.

## Output

A base64-encoded 1200x630 PNG image returned as MCP image content, suitable for use as an Open Graph (og:image) meta tag or social media preview card. The title is truncated to 60 characters and description to 120 characters in the rendered output.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "image": {
   "type": "string",
   "description": "Optional http(s) header image URL"
  },
  "title": {
   "type": "string",
   "description": "Card title, max 60 chars"
  },
  "description": {
   "type": "string",
   "description": "Card description, max 120 chars"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-og-image-generator-aa795509/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)