# Quietforge Family Tree Chart PDF Generator

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

Generates print-ready family tree poster and tiled PDFs (plus editable layout JSON) from structured people/families data or a GEDCOM file, supporting descendant, ancestor, and hourglass chart types across multiple page sizes.

## Facts

- Endpoint: POST https://qf-api.quietforge-studio.workers.dev/v1/familytree/pdf?utm_source=zero.xyz
- Price: $4.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-family-tree-chart-pdf-generator-f1b88a4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AuBFD6ghP6pkRlLcE6VRJ

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-family-tree-chart-pdf-generator-f1b88a4a -d '<json body>'
```

Example prompt: Can you make a descendant family tree chart PDF for the Alvarez family — I have a GEDCOM file I exported from Ancestry — show 5 generations, use the elegant serif style, titled 'The Alvarez Family', and give me both Letter and 24x36 poster sizes?

## When to prefer this

Choose this endpoint when you need to transform genealogical data (structured JSON arrays or a GEDCOM export from Ancestry, FamilySearch, MyHeritage, or Gramps) into a verified, print-ready family tree PDF suitable for posters, tiled home printing, or archival use. It supports multiple page sizes in a single call and offers both classic and elegant typography. Prefer it over generic diagramming tools when you need genealogy-specific layout logic (descendant, ancestor, hourglass), GEDCOM compatibility, or multi-size poster output without signup or API key management — just pay per call with USDC on Base.

## Known failure modes

- Fewer than 3 people provided — validation error
- More than 400 people in subtree — payload too large
- GEDCOM file exceeds 2,000,000 character limit — rejected
- Invalid chart type enum value — bad request
- Generations outside 2–10 range — validation error
- Payment not fulfilled via x402/USDC — 402 Payment Required
- Malformed GEDCOM syntax — parsing error or incomplete chart
- No connected subtree found from root — empty or minimal output

## 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 ZIP archive (base64-encoded) containing one or more print-ready PDF files in the requested page sizes (Letter, A4, 24x36, A3), an optional chart layout JSON, plus metadata fields: root person ID, chart type, style, title, people count, couples count, generations, page counts per size, elapsed milliseconds, and content type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "root": {
   "type": "string",
   "description": "Person id the chart is built from; omitted = chosen automatically (earliest founder with the most descendants, or the person with the most ancestors)"
  },
  "chart": {
   "enum": [
    "descendant",
    "ancestor",
    "hourglass"
   ],
   "type": "string",
   "description": "descendant (default): root and everyone below; ancestor: pedigree of the root; hourglass: both"
  },
  "sizes": {
   "type": "array",
   "items": {
    "enum": [
     "letter",
     "a4",
     "24x36",
     "a3"
    ],
    "type": "string"
   },
   "description": "PDF page sizes to build (PDF route only; default all four)"
  },
  "style": {
   "enum": [
    "classic",
    "elegant"
   ],
   "type": "string",
   "description": "classic = sans-serif, elegant = serif (PDF only)"
  },
  "title": {
   "type": "string",
   "maxLength": 60,
   "description": "Printed above the chart"
  },
  "gedcom": {
   "type": "string",
   "maxLength": 2000000,
   "description": "Alternative to people/families: the text of a GEDCOM 5.5 / 5.5.1 / 7.0 file (as exported by Ancestry, FamilySearch, MyHeritage, Gramps); up to 2,000,000 characters and 400 people in the requested subtree"
  },
  "people": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "name"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "sex": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "birth": {
      "type": "string"
     },
     "death": {
      "type": "string"
     }
    }
   },
   "maxItems": 400,
   "minItems": 3,
   "description": "3-400 people; birth/death are years or GEDCOM-style dates ('abt 1850', '12 MAR 1901'); use with families"
  },
  "families": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string"
     },
     "wife": {
      "type": "string"
     },
     "husband": {
      "type": "string"
     },
     "children": {
      "type": "array",
      "items": {
       "type": "string"
      }
     }
    }
   },
   "maxItems": 300,
   "description": "Couples and their children (GEDCOM FAM model); husband/wife optional, children a list of person ids"
  },
  "subtitle": {
   "type": "string",
   "maxLength": 90,
   "description": "Optional line under the title"
  },
  "generations": {
   "type": "integer",
   "maximum": 10,
   "minimum": 2,
   "description": "Generations to 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "root": "I1",
  "bytes": 120000,
  "chart": "descendant",
  "files": [
   "TheAlvarezFamily-Descendant-24x36.pdf",
   "TheAlvarezFamily-Descendant-Letter.pdf",
   "chart.json"
  ],
  "pages": {
   "24x36": 1,
   "letter": 9
  },
  "style": "elegant",
  "title": "The Alvarez Family",
  "people": 57,
  "couples": 21,
  "elapsed_ms": 1800,
  "generations": 5,
  "content_type": "application/zip",
  "content_base64": "UEsDBBQ..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quietforge-family-tree-chart-pdf-generator-f1b88a4a/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)