用途：通过 tinify.dev 在服务端压缩、缩放、裁剪或转换图像（AVIF、WebP、JPEG、PNG，GIF 仅限网页工具与匿名端点）。压缩不会返回比输入更大的文件；若无法优化会返回原始文件并标记 optimized 为 false。缩放与转换会如实报告体积变化，因为结果可能变大。
使用方式：优先使用 MCP 工具（如 compress_image、resize_image、crop_image、convert_image、get_usage），它们会校验路径、默认不覆盖源文件、在输入旁生成 <name>.min.<ext> 并返回字节数；大批量前先调用 get_usage 查看配额。没有 MCP 但设置了 TINIFY_API_KEY（格式 tnf_live_... 或 tnf_test_...）时，可直接调用 REST API 或使用 CLI：npx -y @tinify-dev/client compress ./img.png --out ./out。两者都没有时，一次性文件可指向 https://tinify.dev 网页工具（免费、无需账号），自动化需在 https://tinify.dev/developers 获取免费密钥，不要编造密钥或跳过认证。
REST API 要点：基址 https://api.tinify.dev/api/v1，Bearer 认证，必须带 Idempotency-Key（任意 UUID，重试同一逻辑请求时复用）。压缩示例：curl -X POST https://api.tinify.dev/api/v1/images/compress -H "Authorization: Bearer $TINIFY_API_KEY" -H "Idempotency-Key: $(uuidgen)" -F "file=@photo.jpg" -F "quality_mode=balanced"（balanced | best_quality | lossless）。其他操作同形：/images/resize（width、height 或 scale，keep_aspect_ratio=true）、/images/crop（x、y、width、height 像素）、/images/convert（format=avif|webp|jpeg|png，同格式返回 422）、compress 还接受 target_size_bytes（>=10240，小于输入体积，检查 target_size_achieved 是否为 true）。GET /usage 返回 plan、used、remaining。响应数据在 data 中并带顶层 request_id，需及时从 data.download_url 下载结果（相对 API 源，两小时后过期）。错误采用固定结构 {"error": {"code", "message"}, "request_id"}，仅在 429/503 时按 Retry-After 重试。
限制与规则：单图最大 40 MB、50 百万像素；结果两小时后过期；免费 API 层每月 500 次成功操作，失败调用不计费；无损模式不支持 JPEG，且不能与 target_size_bytes 组合。不要静默覆盖源文件；报告每个文件的处理前后字节数与总节省量，optimized 为 false 时如实说明。批量处理时一次处理少量文件，遇到认证或配额错误应让整批失败而非静默跳过。转换为“更小”格式可能产生更大文件，需比较字节数并说明取舍。
适用场景：需要缩小或优化图片体积、批量调整尺寸、裁剪或转换格式时。资料未提供具体收费标准及其他细节。