POST/api/worldbuilder$2.00/call

WorldBuilder API

Detailed fictional worlds with consistent lore

Master worldbuilding: detailed fictional worlds with geography, cultures, economies, magic systems, histories, and conflicts. Internally consistent.

Use Cases

Quick Start

Pay per call with USDC on Base (x402). No API key, no signup.

curl

curl -X POST https://mazzagrp.com/api/worldbuilder \
  -H "Content-Type: application/json" \
  -d '{"prompt": "your task, question, or input"}'

Python

import requests
r = requests.post("https://mazzagrp.com/api/worldbuilder", json={"prompt": "your task"})
# 402 -> sign USDC on Base, send PAYMENT-SIGNATURE header, retry
print(r.json())

JavaScript

const res = await fetch("https://mazzagrp.com/api/worldbuilder", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "your task" }),
});
// 402 -> sign with wallet -> retry with PAYMENT-SIGNATURE
const data = await res.json();

Response

{ "success": true, "service": "worldbuilder", "amount": "$2.00", "currency": "USD", "result": "..." }

FAQ

How do I pay?

This is an x402 endpoint. Call it without payment to get an HTTP 402 with the payment requirements. Sign a USDC transfer on Base mainnet (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xD98b6969fab0bA4D4BB086fF273ff7ccD284CEe8, send the PAYMENT-SIGNATURE header back, and receive the AI result. No API key, no signup.

What does it cost?

$2.00 per call, paid in USDC on Base via x402. You only pay for calls you make.

What does it return?

An AI response tailored to the "WorldBuilder" service (detailed fictional worlds with consistent lore). The result is the "result" field in the JSON response.

Related Endpoints