---
tool_name: pdf-overlay
summary: Lay a template, seal or pre-printed form page exactly on top of a base page — perfect registration without printers or Photoshop layers.
input:
  file: binary, required # PDFs: first = base, others = overlay pages (2+) (max 200MB)
  target_page: number, optional, min 1 # 叠加到第几页
output:
  preview_url: string | watermarked preview, free, no auth
  task_id: string | unique task identifier
  payment_url: string | end-user must complete one-time payment to unlock final output
  final_download_url: string | only available after successful payment
auth: login via email/phone OTP on https://pdf-overlay.yeezhan.com; API callers use a personal API key (Bearer yeek_...)
payment_rule: one-time charge $0.99 per task. NO credits, NO account balance. One payment unlocks only this task.
valid_window: 24 hours after payment
errors:
  - file_too_large
  - invalid_input
  - unsupported_type
  - target_unreachable
  - processing_failed
endpoint: https://pdf-overlay.yeezhan.com/api/v1/run
---