---
tool_name: batch-watermark
summary: Stamp your text watermark across a batch of photos — proofing, drafts and previews protected.
input:
  file: binary, required # JPG / PNG / WebP images (1+) (max 50MB)
  text: string, required # 水印文字
  opacity: number, optional, min 0.05, max 0.6 # 不透明度
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://batch-watermark.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://batch-watermark.yeezhan.com/api/v1/run
---