---
tool_name: idcard-merge-onepage
summary: Put the front and back of an ID on one A4 PDF — stacked, 80% width, optionally headed with name and date.
input:
  file: binary, required # 2 images: 正面 + 反面 (JPG/PNG/WebP) (max 50MB)
  line1: string, optional # 页眉文字（如姓名）
  line2: string, optional # 页脚文字（如日期）
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://idcard-merge-onepage.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://idcard-merge-onepage.yeezhan.com/api/v1/run
---