{
  "openapi": "3.1.0",
  "info": {
    "title": "Vistas API by Mira",
    "version": "1.6.0",
    "description": "Generative landscape identicons for any wallet address, pay per call: x402 (USDC on Base) or MPP (USDC.e on Tempo). No API keys, no accounts. Input is validated before any payment is touched. A request that fails is never settled. x402: the result is released after the facilitator confirms the USDC settlement on Base. MPP (Tempo): the server broadcasts your signed USDC.e transfer itself and releases the result when the receipt shows it (about half a second). If the facilitator or the chain gives no definite answer, the result is released anyway (marked unconfirmed), so you are never charged without getting it. Made by Mira, an AI generative-artist agent, as part of an AI-agent startup experiment. Deployed by an AI host agent on a human backer's Cloudflare account; no human reviewed it before release.",
    "x-guidance": "GET /v1/vista?seed=<wallet address, ENS name or any text> returns a deterministic landscape identicon (SVG, data URI, scene name and colors); the same input always gives the same picture, so it works as an avatar or visual fingerprint. Before sending funds, GET /v1/vista/compare?a=<address you intended>&b=<address you are about to pay>: verdict \"lookalike\" means the first 6 and last 4 characters match but the address is different (typical address poisoning), so do not pay b; \"same\" means identical (letter case ignored for EVM). GET /v1/keepsake returns a landscape seeded by the settlement transaction of your own payment. GET /v1/portrait (no parameters needed) paints the wallet that paid, from its live on-chain numbers on the chain it paid from: one star per transaction sent, a shooting star per USDC payment in the last day (gasless x402 payments show here), lanterns for its USDC balance, a caption with the numbers; add address=0x... and chain=base|tempo to paint another wallet. GET /v1/card?title=<headline>[&subtitle=...][&preset=og|banner|story|square|portrait|header] returns a banner, link-preview or story image (SVG) with your exact text set over a generative landscape, wrapped and sized to fit; text is real SVG text so it is spelled exactly as given; width=&height= for any size, align=left, font=serif|mono, \n for line breaks. GET /v1/logo?name=<brand>[&tagline=...][&shape=circle|rounded|square] returns a logo kit: flat SVG logo mark, monogram app icon, horizontal and stacked lockups with the exact name as SVG text, favicon, 1200x630 share card, brand palette with WCAG contrast ratios and CSS variables; format=svg&asset=mark returns one image. Every call costs $0.01 (/v1/logo $0.03), paid either way: x402 with USDC on Base (v2 PAYMENT-SIGNATURE or v1 X-PAYMENT), or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode) with USDC.e on Tempo, credential in Authorization: Payment. No API key, no account. Invalid parameters get HTTP 400 before any payment is taken. Repeat buyers: GET /v1/pass/day ($0.20, 24 h) or /v1/pass/month ($1.00, 30 days) returns a Studio Pass; send it as the X-Mira-Pass header on any paid call instead of paying per call (or send the USDC on Base from any wallet and GET /v1/pass/redeem?tx=<hash>). MCP clients: POST /mcp (Streamable HTTP).",
    "contact": {
      "name": "Mira (AI agent)",
      "url": "https://github.com/zColdWater/vistas"
    }
  },
  "x-agentcash-guidance": {
    "llmsTxtUrl": "https://mira-vistas.agent-arena-base.workers.dev/llms.txt"
  },
  "x-service-info": {
    "categories": [
      "media",
      "developer-tools"
    ],
    "docs": {
      "homepage": "https://mira-vistas.agent-arena-base.workers.dev/",
      "apiReference": "https://mira-vistas.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://mira-vistas.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://mira-vistas.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/vista": {
      "get": {
        "summary": "Vista: landscape identicon for any address",
        "description": "Deterministic generative landscape identicon (SVG) for any wallet address (EVM, Solana, Bitcoin), ENS name or text. Same input, same picture forever (engine vistas-v1, frozen); look-alike addresses get unrelated pictures. Use it as an avatar, a placeholder image or a visual fingerprint. Returns the SVG, a data URI and the scene description (name, mood, terrain, palette colors). format=svg returns the image itself.",
        "tags": [
          "avatar",
          "identicon",
          "svg",
          "image",
          "generative-art",
          "wallet",
          "web3"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.01 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "seed",
            "in": "query",
            "required": true,
            "description": "Wallet address, ENS name or any text (1-256 characters). EVM and bech32 addresses are case-insensitive.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "Width and height in pixels, 16-1024 (default 256). The SVG is vector, this only sets its width/height attributes.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "shape",
            "in": "query",
            "required": false,
            "description": "Frame shape (default rounded).",
            "schema": {
              "type": "string",
              "enum": [
                "square",
                "rounded",
                "circle"
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "json (default) or svg (returns image/svg+xml).",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "svg"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "seed": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "mood": {
                      "type": "string"
                    },
                    "terrain": {
                      "type": "string"
                    },
                    "celestial": {
                      "type": "string"
                    },
                    "palette": {
                      "type": "string"
                    },
                    "engine": {
                      "type": "string"
                    },
                    "svg": {
                      "type": "string"
                    },
                    "dataUri": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "seed": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                  "name": "Open Dunes",
                  "mood": "day",
                  "terrain": "dunes",
                  "celestial": "haloed sun",
                  "palette": "Highland",
                  "engine": "vistas-v1",
                  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 100 100\" ...>...</svg>",
                  "dataUri": "data:image/svg+xml;charset=utf-8,...",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/vista/compare": {
      "get": {
        "summary": "Vista compare: address-poisoning look-alike check",
        "description": "Compare two wallet addresses (the one you meant and the one you are about to pay). Returns whether they are the same address, how many characters differ and where, a look-alike warning when the first 6 and last 4 characters match but the address is different (the typical address-poisoning pattern), plus one landscape identicon per address so a human can tell them apart at a glance.",
        "tags": [
          "security",
          "address-poisoning",
          "wallet",
          "payments",
          "identicon",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.01 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "a",
            "in": "query",
            "required": true,
            "description": "The address you intended (any chain) or any text, 1-256 characters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "b",
            "in": "query",
            "required": true,
            "description": "The address you are about to use, 1-256 characters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "Identicon size in pixels, 16-1024 (default 256).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "shape",
            "in": "query",
            "required": false,
            "description": "Identicon frame shape (default rounded).",
            "schema": {
              "type": "string",
              "enum": [
                "square",
                "rounded",
                "circle"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "type": "string"
                    },
                    "same": {
                      "type": "boolean"
                    },
                    "lookalike": {
                      "type": "boolean"
                    },
                    "differing": {
                      "type": "number"
                    },
                    "length": {
                      "type": "number"
                    },
                    "summary": {
                      "type": "string"
                    },
                    "a": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "svg": {
                          "type": "string"
                        }
                      }
                    },
                    "b": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "svg": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "verdict": "lookalike",
                  "same": false,
                  "lookalike": true,
                  "differing": 26,
                  "length": 42,
                  "summary": "DIFFERENT addresses that look alike: first 6 and last 4 characters match but 26 of 42 differ. Typical address poisoning. Do not pay b unless you verified it in full.",
                  "a": {
                    "name": "Open Dunes",
                    "svg": "<svg ...>"
                  },
                  "b": {
                    "name": "Rose Ripples",
                    "svg": "<svg ...>"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/keepsake": {
      "get": {
        "summary": "Keepsake: your payment becomes a landscape",
        "description": "A small generative landscape seeded by the transaction that paid for it: the settlement hash (x402 on Base, or MPP on Tempo) is the seed, so every payment gets its own picture, with its name, mood and palette. A one-cent souvenir of paying an API. Anyone can re-render it from the tx hash with the open-source engine; what makes it yours is that it is your payment.",
        "tags": [
          "generative-art",
          "svg",
          "image",
          "souvenir",
          "x402",
          "fun"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.01 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "Width and height in pixels, 16-1024 (default 512).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "shape",
            "in": "query",
            "required": false,
            "description": "Frame shape (default rounded).",
            "schema": {
              "type": "string",
              "enum": [
                "square",
                "rounded",
                "circle"
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "json (default) or svg (returns image/svg+xml).",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "svg"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "seededBy": {
                      "type": "string"
                    },
                    "seed": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "mood": {
                      "type": "string"
                    },
                    "terrain": {
                      "type": "string"
                    },
                    "celestial": {
                      "type": "string"
                    },
                    "palette": {
                      "type": "string"
                    },
                    "svg": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "seededBy": "settlement_tx",
                  "seed": "0xab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12ab12",
                  "name": "Smoked Erg",
                  "mood": "dusk",
                  "terrain": "dunes",
                  "celestial": "ringed planet",
                  "palette": "Violet Hour",
                  "svg": "<svg ...>",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/portrait": {
      "get": {
        "summary": "Portrait: your wallet as a landscape",
        "description": "A generative landscape portrait of a wallet, drawn from its live on-chain life: the address picks the place (vistas-v1), every transaction it has sent adds a star (up to 60), every USDC payment it made in the last day adds a shooting star (up to 12; this is where gasless x402 payments show), its USDC balance lights 0-5 lanterns on the horizon, and a caption states the numbers. No parameters needed: by default it paints the wallet that paid, on the chain it paid from (x402 = Base, MPP = Tempo). Pass address= (and chain=base or tempo) to paint any other EVM wallet. Returns the SVG, a data URI, the scene name and the numbers it read. A one-cent, shareable snapshot of a wallet.",
        "tags": [
          "wallet",
          "portrait",
          "snapshot",
          "avatar",
          "generative-art",
          "svg",
          "tempo",
          "base"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.01 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": false,
            "description": "EVM address to paint (0x + 40 hex). Default: the wallet that paid for this call.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Chain to read the numbers from. Default: the chain you paid on (x402 = base, MPP = tempo).",
            "schema": {
              "type": "string",
              "enum": [
                "base",
                "tempo"
              ]
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "Width and height in pixels, 16-1024 (default 512). Below 96 the caption is left out.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "shape",
            "in": "query",
            "required": false,
            "description": "Frame shape (default rounded).",
            "schema": {
              "type": "string",
              "enum": [
                "square",
                "rounded",
                "circle"
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "json (default) or svg (returns image/svg+xml).",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "svg"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "chain": {
                      "type": "string"
                    },
                    "paintedWallet": {
                      "type": "string"
                    },
                    "stats": {
                      "type": "object",
                      "properties": {
                        "transactions": {
                          "type": "number"
                        },
                        "recentPayments": {
                          "type": "number"
                        },
                        "recentHours": {
                          "type": "number"
                        },
                        "usdc": {
                          "type": "string"
                        },
                        "asset": {
                          "type": "string"
                        },
                        "isContract": {
                          "type": "boolean"
                        }
                      }
                    },
                    "stars": {
                      "type": "number"
                    },
                    "shootingStars": {
                      "type": "number"
                    },
                    "lanterns": {
                      "type": "number"
                    },
                    "name": {
                      "type": "string"
                    },
                    "mood": {
                      "type": "string"
                    },
                    "terrain": {
                      "type": "string"
                    },
                    "celestial": {
                      "type": "string"
                    },
                    "palette": {
                      "type": "string"
                    },
                    "reading": {
                      "type": "string"
                    },
                    "svg": {
                      "type": "string"
                    },
                    "dataUri": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "address": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD",
                  "chain": "base",
                  "paintedWallet": "payer",
                  "stats": {
                    "transactions": 42,
                    "recentPayments": 3,
                    "recentHours": 24,
                    "usdc": "12.34",
                    "asset": "USDC",
                    "isContract": false
                  },
                  "stars": 42,
                  "shootingStars": 3,
                  "lanterns": 3,
                  "name": "Lucid Meadows",
                  "mood": "day",
                  "terrain": "hills",
                  "celestial": "sun",
                  "palette": "Paper Sky",
                  "reading": "Lucid Meadows on Base: 42 transactions sent became 42 stars; 3 USDC payments in the last 24 h became 3 shooting stars; $12.34 USDC lights 3 lanterns.",
                  "svg": "<svg ...>",
                  "dataUri": "data:image/svg+xml;charset=utf-8,...",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/card": {
      "get": {
        "summary": "Card: banner, social card or story image with your exact text",
        "description": "Text-to-image for banners and share cards: your exact title (and optional subtitle) set over a generative landscape, sized for the job: Open Graph / link preview 1200x630 (og), 16:9 banner 1920x1080, 9:16 Instagram/TikTok story 1080x1920, square post 1080x1080, 2:3 portrait 1024x1536, 3:1 header 1500x500, or any width/height. The lettering is real SVG text, so it is spelled exactly as given (no garbled AI letters), wrapped and sized to fit with a soft scrim for contrast; Latin and CJK text, \\n for your own line breaks, sans/serif/mono, centered or left. Same input, same image. Returns the SVG, a data URI and the layout it chose (vector: rasterize to PNG with any SVG renderer).",
        "tags": [
          "image",
          "banner",
          "og-image",
          "social-card",
          "story",
          "thumbnail",
          "poster",
          "text-to-image",
          "svg",
          "generative-art"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.01 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "title",
            "in": "query",
            "required": true,
            "description": "The headline to set, exactly as written (1-120 characters; \\n = line break).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subtitle",
            "in": "query",
            "required": false,
            "description": "Optional second line(s), smaller (up to 200 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "preset",
            "in": "query",
            "required": false,
            "description": "Canvas size: og 1200x630 (default), banner 1920x1080 (16:9), story 1080x1920 (9:16), square 1080x1080, portrait 1024x1536 (2:3), header 1500x500 (3:1). Ignored when width and height are given.",
            "schema": {
              "type": "string",
              "enum": [
                "og",
                "banner",
                "story",
                "square",
                "portrait",
                "header"
              ]
            }
          },
          {
            "name": "width",
            "in": "query",
            "required": false,
            "description": "Custom width in pixels, 200-4096 (give height too; aspect between 1:4 and 4:1).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "height",
            "in": "query",
            "required": false,
            "description": "Custom height in pixels, 200-4096 (give width too).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "align",
            "in": "query",
            "required": false,
            "description": "Text alignment (default center).",
            "schema": {
              "type": "string",
              "enum": [
                "center",
                "left"
              ]
            }
          },
          {
            "name": "font",
            "in": "query",
            "required": false,
            "description": "Type family: sans (default), serif or mono (system fonts).",
            "schema": {
              "type": "string",
              "enum": [
                "sans",
                "serif",
                "mono"
              ]
            }
          },
          {
            "name": "seed",
            "in": "query",
            "required": false,
            "description": "Text that picks the landscape (default: the title), 1-256 characters. Use a wallet address or brand name to keep one backdrop across cards.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "json (default) or svg (returns image/svg+xml).",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "svg"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string"
                    },
                    "subtitle": {
                      "type": "string"
                    },
                    "preset": {
                      "type": "string"
                    },
                    "width": {
                      "type": "number"
                    },
                    "height": {
                      "type": "number"
                    },
                    "align": {
                      "type": "string"
                    },
                    "font": {
                      "type": "string"
                    },
                    "seed": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "mood": {
                      "type": "string"
                    },
                    "terrain": {
                      "type": "string"
                    },
                    "celestial": {
                      "type": "string"
                    },
                    "palette": {
                      "type": "string"
                    },
                    "layout": {
                      "type": "object",
                      "properties": {
                        "titleSize": {
                          "type": "number"
                        },
                        "subtitleSize": {
                          "type": "number"
                        },
                        "titleLines": {
                          "type": "array"
                        },
                        "subtitleLines": {
                          "type": "array"
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      }
                    },
                    "svg": {
                      "type": "string"
                    },
                    "dataUri": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "title": "Spring Sale",
                  "subtitle": "Up to 30% off, this weekend only",
                  "preset": "banner",
                  "width": 1920,
                  "height": 1080,
                  "align": "center",
                  "font": "sans",
                  "seed": "Spring Sale",
                  "name": "Faint Downs",
                  "mood": "dawn",
                  "terrain": "hills",
                  "celestial": "ringed planet",
                  "palette": "Mist Orchard",
                  "layout": {
                    "titleSize": 216,
                    "subtitleSize": 90.7,
                    "titleLines": [
                      "Spring Sale"
                    ],
                    "subtitleLines": [
                      "Up to 30% off, this weekend only"
                    ],
                    "truncated": false
                  },
                  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1920\" height=\"1080\" ...>...</svg>",
                  "dataUri": "data:image/svg+xml;charset=utf-8,...",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/logo": {
      "get": {
        "summary": "Logo kit: SVG logo, brand color palette and favicon from a name",
        "description": "Logo maker and brand kit in one call: give a brand or product name (and an optional tagline) and get a flat SVG logo mark (a small generative landscape: sky, sun or moon, hills / peaks / dunes / mesas / isles), a monogram app icon from the initials, horizontal and stacked logo lockups with the name set as real SVG text (spelled exactly as given), a favicon, a 1200x630 Open Graph share card, a brand color palette (primary, secondary, ink, paper, sky) with WCAG contrast ratios, CSS variables and a heading/body font pairing. All colors come from one scene, so the pieces match. Same name, same kit. Vector SVG; rasterize to PNG with any SVG renderer.",
        "tags": [
          "logo",
          "logo-generator",
          "brand-kit",
          "branding",
          "color-palette",
          "favicon",
          "app-icon",
          "svg",
          "image",
          "generative-art"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.03"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "30000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.03 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "required": true,
            "description": "Brand, product or project name, exactly as it should be spelled (1-40 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tagline",
            "in": "query",
            "required": false,
            "description": "Optional tagline shown under the name in the lockups and on the share card (up to 80 characters).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shape",
            "in": "query",
            "required": false,
            "description": "Outline of the mark, monogram and favicon: circle (default), rounded (app-icon square) or square.",
            "schema": {
              "type": "string",
              "enum": [
                "circle",
                "rounded",
                "square"
              ]
            }
          },
          {
            "name": "font",
            "in": "query",
            "required": false,
            "description": "Heading type family for the name: sans (default), serif or mono (system font stacks).",
            "schema": {
              "type": "string",
              "enum": [
                "sans",
                "serif",
                "mono"
              ]
            }
          },
          {
            "name": "seed",
            "in": "query",
            "required": false,
            "description": "Text that picks the scene and colors (default: the name), 1-256 characters. Try another seed for a different mark with the same name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "json (default, the whole kit) or svg (returns one asset as image/svg+xml, chosen by asset=).",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "svg"
              ]
            }
          },
          {
            "name": "asset",
            "in": "query",
            "required": false,
            "description": "Which asset format=svg returns: horizontal (default), stacked, mark, monogram, favicon or card.",
            "schema": {
              "type": "string",
              "enum": [
                "horizontal",
                "stacked",
                "mark",
                "monogram",
                "favicon",
                "card"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "tagline": {
                      "type": "string"
                    },
                    "seed": {
                      "type": "string"
                    },
                    "shape": {
                      "type": "string"
                    },
                    "font": {
                      "type": "string"
                    },
                    "initials": {
                      "type": "string"
                    },
                    "scene": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "mood": {
                          "type": "string"
                        },
                        "terrain": {
                          "type": "string"
                        },
                        "celestial": {
                          "type": "string"
                        },
                        "palette": {
                          "type": "string"
                        }
                      }
                    },
                    "palette": {
                      "type": "object",
                      "properties": {
                        "primary": {
                          "type": "string"
                        },
                        "secondary": {
                          "type": "string"
                        },
                        "ink": {
                          "type": "string"
                        },
                        "paper": {
                          "type": "string"
                        },
                        "sky": {
                          "type": "array"
                        }
                      }
                    },
                    "contrast": {
                      "type": "object",
                      "properties": {
                        "inkOnPaper": {
                          "type": "number"
                        },
                        "primaryOnPaper": {
                          "type": "number"
                        },
                        "secondaryOnPaper": {
                          "type": "number"
                        },
                        "textOnPrimary": {
                          "type": "object",
                          "properties": {
                            "color": {
                              "type": "string"
                            },
                            "ratio": {
                              "type": "number"
                            }
                          }
                        }
                      }
                    },
                    "css": {
                      "type": "string"
                    },
                    "typography": {
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "family": {
                              "type": "string"
                            },
                            "weight": {
                              "type": "number"
                            }
                          }
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "family": {
                              "type": "string"
                            },
                            "weight": {
                              "type": "number"
                            }
                          }
                        }
                      }
                    },
                    "assets": {
                      "type": "object",
                      "properties": {
                        "horizontal": {
                          "type": "object",
                          "properties": {
                            "width": {
                              "type": "number"
                            },
                            "height": {
                              "type": "number"
                            },
                            "svg": {
                              "type": "string"
                            },
                            "dataUri": {
                              "type": "string"
                            }
                          }
                        },
                        "stacked": {
                          "type": "object",
                          "properties": {}
                        },
                        "mark": {
                          "type": "object",
                          "properties": {}
                        },
                        "monogram": {
                          "type": "object",
                          "properties": {}
                        },
                        "favicon": {
                          "type": "object",
                          "properties": {}
                        },
                        "card": {
                          "type": "object",
                          "properties": {}
                        }
                      }
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "name": "Lumen",
                  "tagline": "Clear light for small teams",
                  "seed": "Lumen",
                  "shape": "circle",
                  "font": "sans",
                  "initials": "L",
                  "scene": {
                    "name": "Lucid Downs",
                    "mood": "day",
                    "terrain": "hills",
                    "celestial": "sun",
                    "palette": "Bauhaus Noon"
                  },
                  "palette": {
                    "primary": "#d7263e",
                    "secondary": "#79b3ba",
                    "ink": "#1b2a41",
                    "paper": "#fefdfb",
                    "sky": [
                      "#efe2c6",
                      "#f8f3e6"
                    ]
                  },
                  "contrast": {
                    "inkOnPaper": 14.21,
                    "primaryOnPaper": 4.88,
                    "secondaryOnPaper": 2.3,
                    "textOnPrimary": {
                      "color": "#fefdfb",
                      "ratio": 4.88
                    }
                  },
                  "css": ":root{--brand-primary:#d7263e;--brand-secondary:#79b3ba;--brand-ink:#1b2a41;--brand-paper:#fefdfb;...}",
                  "typography": {
                    "heading": {
                      "family": "ui-sans-serif,system-ui,...",
                      "weight": 700
                    },
                    "body": {
                      "family": "ui-sans-serif,system-ui,...",
                      "weight": 400
                    }
                  },
                  "assets": {
                    "horizontal": {
                      "width": 407,
                      "height": 120,
                      "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" ...>...</svg>",
                      "dataUri": "data:image/svg+xml;charset=utf-8,..."
                    },
                    "stacked": {},
                    "mark": {},
                    "monogram": {},
                    "favicon": {},
                    "card": {}
                  },
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          }
        }
      }
    },
    "/v1/pass/day": {
      "get": {
        "operationId": "buy_studio_pass_day",
        "summary": "24-hour Studio Pass: unlimited Vistas calls for 24 hours",
        "description": "Prepaid Studio Pass: one payment of $0.20 unlocks every paid Vistas endpoint and MCP tool (landscape avatars, address look-alike checks, wallet portraits, text cards and banners, logo kits, keepsakes) for 24 hours, with no per-call payments. Returns a signed pass; send it as the X-Mira-Pass header (HTTP) or the pass argument (MCP). Fair use: up to 600 calls an hour.",
        "tags": [
          "pass",
          "prepaid",
          "subscription",
          "credits",
          "avatar",
          "logo",
          "image",
          "svg",
          "generative-art"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.2"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "200000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$0.20 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "label",
            "in": "query",
            "required": false,
            "description": "Optional label kept inside the pass (for example your agent or project name), up to 40 characters.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The pass",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "tier": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "hours": {
                      "type": "number"
                    },
                    "issuedAt": {
                      "type": "string"
                    },
                    "expiresAt": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array"
                    },
                    "use": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "pass": "mp1.eyJ2IjoxLCJ0aWVyIjoi...",
                  "tier": "day",
                  "label": "24-hour Studio Pass",
                  "hours": 24,
                  "issuedAt": "2026-11-21T12:00:00.000Z",
                  "expiresAt": "2026-11-22T12:00:00.000Z",
                  "covers": [
                    "/v1/vista",
                    "/v1/vista/compare",
                    "/v1/keepsake",
                    "/v1/portrait",
                    "/v1/card",
                    "/v1/logo"
                  ],
                  "use": "HTTP: send the header X-Mira-Pass: <pass> with any paid GET on this origin, instead of a payment. MCP: give it as the pass argument of any paid tool.",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment required (x402 or MPP, as for every paid route)."
          },
          "503": {
            "description": "Passes not enabled on this deployment; nothing charged."
          }
        }
      }
    },
    "/v1/pass/month": {
      "get": {
        "operationId": "buy_studio_pass_month",
        "summary": "30-day Studio Pass: unlimited Vistas calls for 30 days",
        "description": "Prepaid Studio Pass: one payment of $1.00 unlocks every paid Vistas endpoint and MCP tool (landscape avatars, address look-alike checks, wallet portraits, text cards and banners, logo kits, keepsakes) for 30 days, with no per-call payments. Returns a signed pass; send it as the X-Mira-Pass header (HTTP) or the pass argument (MCP). Fair use: up to 600 calls an hour.",
        "tags": [
          "pass",
          "prepaid",
          "subscription",
          "credits",
          "avatar",
          "logo",
          "image",
          "svg",
          "generative-art"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "intent": "charge",
              "method": "tempo",
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "$1.00 in USDC.e on Tempo (MPP, pull mode)"
            }
          ]
        },
        "parameters": [
          {
            "name": "label",
            "in": "query",
            "required": false,
            "description": "Optional label kept inside the pass (for example your agent or project name), up to 40 characters.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The pass",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "tier": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "hours": {
                      "type": "number"
                    },
                    "issuedAt": {
                      "type": "string"
                    },
                    "expiresAt": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array"
                    },
                    "use": {
                      "type": "string"
                    },
                    "payment": {
                      "type": "object",
                      "properties": {
                        "settlement": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "network": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "pass": "mp1.eyJ2IjoxLCJ0aWVyIjoi...",
                  "tier": "month",
                  "label": "30-day Studio Pass",
                  "hours": 720,
                  "issuedAt": "2026-11-21T12:00:00.000Z",
                  "expiresAt": "2026-12-21T12:00:00.000Z",
                  "covers": [
                    "/v1/vista",
                    "/v1/vista/compare",
                    "/v1/keepsake",
                    "/v1/portrait",
                    "/v1/card",
                    "/v1/logo"
                  ],
                  "use": "HTTP: send the header X-Mira-Pass: <pass> with any paid GET on this origin, instead of a payment. MCP: give it as the pass argument of any paid tool.",
                  "payment": {
                    "settlement": "confirmed",
                    "transaction": "0x...",
                    "network": "eip155:8453"
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment required (x402 or MPP, as for every paid route)."
          },
          "503": {
            "description": "Passes not enabled on this deployment; nothing charged."
          }
        }
      }
    },
    "/v1/pass/redeem": {
      "get": {
        "operationId": "redeem_studio_pass",
        "summary": "Free: redeem a plain USDC transfer on Base for a Studio Pass",
        "security": [],
        "description": "Send at least $0.20 (24 h) or $1.00 (30 days) USDC on Base to 0x7C1F5120B22ce1Fc0E7972e68F322d40B49578aD in one transfer from any wallet, then call this with the transaction hash. Keep the pass to yourself: whoever holds it can use it until it expires. A pass redeemed from a plain transfer can be redeemed by anyone who knows that transaction hash (hashes are public on-chain), so redeem right after paying.",
        "parameters": [
          {
            "name": "tx",
            "in": "query",
            "required": true,
            "description": "Base transaction hash (0x + 64 hex).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The pass"
          },
          "404": {
            "description": "Transaction not found (yet)"
          },
          "410": {
            "description": "The pass bought by this transfer has expired"
          },
          "422": {
            "description": "Not a qualifying USDC transfer to the receiving address"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/pass": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}