---
tool_name: crop-ratio
summary: Crop to exact aspect ratio — 1:1, 4:3, 16:9 or custom, center or top-aligned.
input:
  file: binary, required # JPG / PNG / WebP image (max 50MB)
  ratio_w: number, required # 宽比
  ratio_h: number, required # 高比
  position: enum, 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://crop-ratio.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://crop-ratio.yeezhan.com/api/v1/run
---