# Quietforge Sudoku Generator

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

Generates solver-verified, technique-graded Sudoku puzzles in JSON format, with optional seeding for reproducibility and configurable counts per difficulty level.

## Facts

- Endpoint: POST https://qf-api.quietforge-studio.workers.dev/v1/sudoku?utm_source=zero.xyz
- Price: $0.01/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-generator-4e5fde6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PE1x1eJpcbD9eG9h6TuMh

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-generator-4e5fde6b -d '<json body>'
```

Example prompt: Generate 3 sudoku puzzles for me — 1 easy, 1 medium, and 1 hard — using seed 42, and give me the solutions and the solving techniques required for each.

## When to prefer this

Choose this endpoint when you need programmatically generated, solver-verified Sudoku puzzles with explicit technique grading and solutions in a structured JSON format. It is ideal for puzzle apps, educational tools, testing sudoku solvers, or generating reproducible puzzle sets via seed. Prefer this over generic puzzle APIs when you need confirmed unique solutions and transparent solving technique metadata. Payment via x402/USDC on Base means no account signup or API key management.

## Known failure modes

- Total puzzle count exceeds 20 — returns validation error
- Invalid difficulty level key in counts object — ignored or returns error
- Payment not provided or insufficient USDC via x402 — returns 402 Payment Required
- Malformed JSON body — returns 400 Bad Request
- Seed produces no valid puzzle within time limits — may return timeout or empty result

## 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

Returns a JSON object containing the seed used, total puzzle count, format description, grading criteria per level, and an array of puzzle objects each with: puzzle number, difficulty level, number of givens, an 81-character puzzle string (0=empty), an 81-character solution string, a list of solving techniques required, symmetry type, elapsed generation time in ms, and a boolean confirming the solution is unique.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "integer",
   "description": "Optional; same seed + counts = same puzzles"
  },
  "counts": {
   "type": "object",
   "properties": {
    "easy": {
     "type": "integer",
     "maximum": 20,
     "minimum": 0
    },
    "hard": {
     "type": "integer",
     "maximum": 20,
     "minimum": 0
    },
    "expert": {
     "type": "integer",
     "maximum": 20,
     "minimum": 0
    },
    "medium": {
     "type": "integer",
     "maximum": 20,
     "minimum": 0
    }
   },
   "description": "Puzzles per level; total 1-20"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "seed": 12345,
  "count": 1,
  "format": "puzzle/solution: 81 characters, row by row, 0 = empty",
  "grading": {
   "easy": "naked + hidden singles only",
   "hard": "+ naked triples, hidden pairs, X-wing",
   "expert": "those techniques are not enough",
   "medium": "+ naked pairs, pointing pairs, box-line reduction"
  },
  "puzzles": [
   {
    "n": 1,
    "level": "hard",
    "givens": 26,
    "puzzle": "000200090000000450080000000970000006000508000600000023000000060032000000010007000",
    "solution": "351264897296873451487159362973421586124538679658796123745312968832945716519687234",
    "techniques": [
     "hidden single",
     "naked single",
     "box-line reduction",
     "naked pair",
     "pointing pair",
     "naked triple"
    ]
   }
  ],
  "symmetry": "180-degree",
  "elapsed_ms": 2100,
  "unique_solution": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quietforge-sudoku-generator-4e5fde6b/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)