Geometry

# Geometry — AI Image Generation API

> Generate images from text prompts. Pay per request with USDC on Solana via [x402](https://x402.org). No API keys, no accounts.

- **Homepage:** https://geometry.sh
- **Agent Card:** https://api.geometry.sh/.well-known/agent.json
- **Docs:** https://app.geometry.sh/developers

## Payment

| Field | Value |
|-------|-------|
| Protocol | x402 (version 2) |
| Network | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` |
| Scheme | exact |
| Currency | USDC |
| Facilitator | https://facilitator.payai.network |
| Pay To | `79BLYwUdsNpPzDktxjibFR4DKMhHV2Q8iBu7Fk7R9fuU` |

## Endpoints

### GET /api/x402/generate/quote

Get the USDC price for a model. **Free — no payment required.**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| model | string | no | Model slug (default: `flux-dev`) |

**Example response:**

```json
{
  "success": true,
  "data": {
    "model": "flux-dev",
    "costUsdc": 0.0325,
    "paymentNetwork": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "79BLYwUdsNpPzDktxjibFR4DKMhHV2Q8iBu7Fk7R9fuU"
  }
}
```

### POST /api/x402/generate

Generate an AI image from a text prompt. **Requires x402 USDC payment.**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| prompt | string | yes | Text prompt (1–1000 chars) |
| model | string | no | Model slug (default: `flux-dev`) |

**Example request:**

```json
{
  "prompt": "A neon-lit Tokyo alley in the rain",
  "model": "flux-dev"
}
```

**Example response:**

```json
{
  "success": true,
  "data": {
    "id": "ab0e4a1b-179f-4a6e-b505-53206a3e2e4b",
    "status": "completed",
    "prompt": "A neon-lit Tokyo alley in the rain",
    "model": "flux-dev",
    "costUsdc": 0.0325,
    "imageUrl": "https://cdn.geometry.sh/generations/user-id/gen-id.png",
    "createdAt": "2026-02-15T17:29:17.256Z"
  }
}
```

## Available Models

| Slug | Name | Price (USDC) |
|------|------|-------------|
| bagel...