AgentGen — HTML → PDF & Image

Convert any HTML to a PDF or screenshot image via the AgentGen API.

Free tier — no sign-up required

The /v1/generate/image and /v1/generate/pdf endpoints work without an API key. Just omit the X-API-Key header.

Limits: - 1 request per 60 seconds per IP (returns 429 if exceeded) - Single-page PDFs only - A small agent-gen.com watermark is added to all output

# Free tier — generate an image (no API key)
agentgen image --html "<h1>Hello</h1>" --output hello.png

# Free tier — generate a PDF (no API key)
agentgen pdf --html "<h1>Invoice</h1>" --output invoice.pdf

Simply omit AGENTGEN_API_KEY and the CLI uses the free tier automatically.

Authenticated tier — no watermark, no rate limit

Set your API key to use the full API. New accounts at agent-gen.com include free tokens — no credit card required to get started.

export AGENTGEN_API_KEY=your_key_here

Check your balance:

agentgen balance

If you run out, the CLI prints your current balance, the amount required, and a direct link to buy more tokens.

Generate an image (1 token authenticated / free with watermark)

# From a file
agentgen image --file page.html --output screenshot.png

# Custom viewport
agentgen image --file page.html --width 1200 --height 630 --output og.png

# JPEG at 2× scale
agentgen image --file page.html --format jpeg --scale 2 --output hero.jpg

Formats: png (default), jpeg, webp Default viewport: 1200 × 630 px

Generate a PDF (2 tokens/page authenticated / free single-page with watermark)

# Single page from a file
agentgen pdf --file report.html --output report.pdf

# With paper format and margins
agentgen pdf --file report.html 
  --format A4 
  --margin-top 20mm --margin-bottom 20mm 
  --margin-left 15mm --margin-right 15mm 
  --print-background 
  --output report.pdf

# Multi-page (requires API key)
agentgen pdf --pages cover.html chapter1.html chapter2.html --output book.pdf

# Landscape
agentgen pdf --file slide.html --landscape --output slide.pdf

Paper formats: A4 (default), Letter, A3, Legal

Upload a temp file (free, authenticated only)

Upload images, fonts, or other assets and reference them by URL inside your HTML. Files are publicly accessible for 24 hours.

agentgen upload logo.png
# Returns a URL — use it in your HTML as <img src="...">

Max file size: 10 MB

Typical workflow

1. Build HTML with all styles inlined
2. Upload any local assets with agentgen upload and replace src/href values with the returned URLs
3. Run agentgen pdf or agentgen image with --output to save locally, or use the returned URL directly

Tips for good output

• Inline all CSS — use <style> blocks or style="" attributes. No access to local stylesheets.
• Use absolute URLs for images and fonts, or upload them first with agentgen upload.
• For PDFs, use --print-background if your design has colored backgrounds or background images.
• For retina-quality images, use --scale 2.
• For OG images, use --width 1200 --height 630.