# Quietforge Sudoku Book Generator

> Quietforge Sudoku Book Generator is a paid API for AI agents from qf-api.quietforge-studio.workers.dev, paid per call via x402, $3.99/call, status unknown (last checked 2026-10-11).

Generates a solver-verified, technique-graded sudoku puzzle book as a print-ready PDF (A4 and Letter) plus JSON puzzles and README, returned as a base64-encoded ZIP

## Facts

- Endpoint: POST https://qf-api.quietforge-studio.workers.dev/v1/sudoku/book?utm_source=zero.xyz
- Price: $3.99/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quietforge-sudoku-book-generator-25c7a701
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K1pbaXqFNQMoL2cfwT-0Z

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 quietforge-sudoku-book-generator-25c7a701 -d '<json body>'
```

Example prompt: Can you generate a personalized sudoku puzzle book called 'Grandma June's Puzzles' with 10 easy, 10 medium, 10 hard, and 10 expert puzzles in standard size, with the dedication 'For June, who loves a challenge'?

## When to prefer this

Choose this endpoint when you need a fully typeset, solver-verified sudoku puzzle book with graded difficulty levels delivered as print-ready PDFs (A4 + Letter) in a single pay-per-call request. Prefer it over DIY puzzle generation when you need KDP-ready formatting, multiple difficulty tiers, a personalized title and dedication, reproducible output via seed, and both large-print and standard layouts — all without any signup or API key.

## Known failure modes

- Total puzzle count outside 30–60 range causes validation error
- Individual difficulty counts exceeding maximum of 60 each rejected
- Invalid size enum value (not 'standard' or 'large') causes bad request
- Payment via x402 not completed or insufficient USDC balance blocks execution
- Long generation time (~14 seconds) may cause client timeout if not handled
- Name exceeding 50 characters or dedication exceeding 200 characters rejected

## How this service works

Pay-per-call document conversion, PDF text extraction, headless-browser rendering of a URL or HTML to PNG / JPEG / PDF, a health-probed directory of x402 pay-per-call endpoints, a sudoku generator (solver-verified, technique-graded puzzles as JSON or a print-ready A4/Letter book), a book typesetter (prose manuscript to a KDP-ready interior PDF + editable docx), a crossword generator (verified freeform grid from your clue/answer pairs as JSON or print-ready PDFs), a family tree chart layout engine (descendant / ancestor / hourglass charts from people+families JSON or a GEDCOM file, as verified layout JSON or print-ready poster and tiled PDFs), and a dataset quality audit tool (duplicates, missing values, type consistency, class imbalance, numeric outliers and PII-pattern counts for a CSV/JSON dataset, as JSON or a one-page PDF summary). Payment: x402 (USDC on Base). No signup, no API key.

## Output

A base64-encoded ZIP file containing: two print-ready PDF files (A4 and Letter format), a JSON file with all puzzle grids and solutions, and a README. The response metadata includes the seed used, total puzzle count, page count, file size in bytes, content type, and elapsed generation time in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 50,
   "description": "Name printed on the title page"
  },
  "seed": {
   "type": "integer",
   "description": "Optional; deterministic rebuilds"
  },
  "size": {
   "enum": [
    "standard",
    "large"
   ],
   "type": "string",
   "description": "standard = 4 puzzles per page, large = 2 (large print)"
  },
  "counts": {
   "type": "object",
   "properties": {
    "easy": {
     "type": "integer",
     "maximum": 60,
     "minimum": 0
    },
    "hard": {
     "type": "integer",
     "maximum": 60,
     "minimum": 0
    },
    "expert": {
     "type": "integer",
     "maximum": 60,
     "minimum": 0
    },
    "medium": {
     "type": "integer",
     "maximum": 60,
     "minimum": 0
    }
   },
   "description": "Puzzles per level; total 30-60"
  },
  "dedication": {
   "type": "string",
   "maxLength": 200,
   "description": "Optional line under the title"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Grandma June",
  "seed": 12345,
  "size": "standard",
  "bytes": 210000,
  "count": 30,
  "files": [
   "GrandmaJune-Sudoku-Book-API-A4.pdf",
   "GrandmaJune-Sudoku-Book-API-Letter.pdf",
   "GrandmaJune-Sudoku-Book-API-puzzles.json",
   "README.txt"
  ],
  "pages": 18,
  "elapsed_ms": 14000,
  "content_type": "application/zip",
  "content_base64": "UEsDBBQ..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quietforge-sudoku-book-generator-25c7a701/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from qf-api.quietforge-studio.workers.dev](https://www.zero.xyz/host/qf-api.quietforge-studio.workers.dev/llms.txt)