Geometry — AI Image Generation API

Generate images from text prompts. Pay per request with USDC on Solana via x402. 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:

{
  "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:

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

Example response:

{
  "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	Bagel	$0.1300
bytedance-seedream-v4.5-text-to-image	Bytedance	$0.0520
bytedance-seedream-v3-text-to-image	Bytedance	$0.0390
bytedance-dreamina-v3.1-text-to-image	Bytedance	$0.0390
bytedance-seedream-v4-text-to-image	Bytedance Seedream v4	$0.0390
emu-3.5-image-text-to-image	Emu 3.5 Image	$0.1950
flux-pro-kontext-max-text-to-image	FLUX.1 Kontext [max]	$0.1040
flux-pro-kontext-text-to-image	FLUX.1 Kontext [pro]	$0.0520
flux-dev	FLUX.1 [dev]	$0.0325
flux-pro-v1.1-ultra	FLUX1.1 [pro] ultra	$0.0780
bria-fibo-generate	Fibo	$0.0520
bria-fibo-lite-generate	Fibo Lite	$0.0468
gemini-25-flash-image	Gemini 2.5 Flash Image	$0.0517
gemini-3-pro-image-preview	Gemini 3 Pro Image Preview	$0.1950
xai-grok-imagine-image	Grok Imagine Image	$0.0260
ideogram-v3	Ideogram Text to Image	$0.0390
ideogram-v2	Ideogram V2	$0.1040
imagen4-preview	Imagen 4	$0.0520
imagen4-preview-fast	Imagen 4	$0.0260
imagen4-preview-ultra	Imagen 4 Ultra	$0.0780
kling-image-v3-text-to-image	Kling Image	$0.0364
kling-image-o3-text-to-image	Kling Image	$0.0364
minimax-image-01	MiniMax (Hailuo AI) Text to Image	$0.0130
nano-banana	Nano Banana	$0.0517
nano-banana-pro	Nano Banana Pro	$0.1950
qwen-image-max-text-to-image	Qwen Image Max	$0.0975
recraft-v3-text-to-image	Recraft V3	$0.0520
reve-text-to-image	Reve	$0.0520
vidu-q2-text-to-image	Vidu	$0.0650
wan-v2.2-5b-text-to-image	Wan	$0.0208
wan-v2.2-a14b-text-to-image	Wan	$0.0325
wan-25-preview-text-to-image	Wan 2.5 Text to Image	$0.0650
wan-v2.2-a14b-text-to-image-lora	Wan v2.2 A14B Text-to-Image A14B with LoRAs	$0.0650

Quick Start

JavaScript

import { createKeyPairSignerFromBytes } from "@solana/kit";
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactSvmScheme } from "@x402/svm/exact/client";

const signer = await createKeyPairSignerFromBytes(keypairBytes);
const client = new x402Client();
client.register("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", new ExactSvmScheme(signer));

const fetchWithPay = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPay("https://api.geometry.sh/api/x402/generate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "A cat in space" }),
});

const { data } = await res.json();
console.log(data.imageUrl);

cURL

# Step 1: Get a quote (free)
curl https://api.geometry.sh/api/x402/generate/quote?model=flux-dev

# Step 2: POST to generate (returns 402 with payment instructions)
curl -X POST https://api.geometry.sh/api/x402/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat in space", "model": "flux-dev"}'

# Step 3: Use an x402 client to handle payment automatically
# npm install @x402/fetch @x402/svm