SuperAPI AI 工具集

tinify-images

设计与创作

查看项目

更新于 10-16 09:35

技能介绍

用途:Tinify Images 用于把图片变小、优化或转换格式,处理在服务端完成,并如实报告结果。压缩不会返回比输入更大的文件;若无法更小,会返回原文件并标记 optimized 为 false。缩放和格式转换会直接报告体积变化,因为它们可能使文件变大。

主要能力:支持压缩(quality_mode 可选 balanced、best_quality、lossless)、缩放(width、height 或 scale,keep_aspect_ratio)、裁剪(x、y、width、height)和格式转换(avif、webp、jpeg、png,同格式会返回 422)。压缩还接受 target_size_bytes(需不小于 10240 且小于输入),响应中 target_size_achieved 为 false 表示尽力而为。

使用方式:有名为 tinify 的 MCP 工具(compress_image、resize_image、crop_image、convert_image、get_usage)时优先使用,它们会校验路径、默认不覆盖源文件、在输入旁写出 <name>.min.<ext> 并返回字节数。也可直接调用 REST API,基础地址 https://api.tinify.dev/api/v1,需 Bearer 认证、Idempotency-Key 请求头,响应数据在 data 中并含 request_id,结果需在两小时内从 data.download_url 下载。CLI 示例:npx -y @tinify-dev/client compress ./img.png --out ./out。无 MCP 且无密钥时,一次性文件可引导至 https://tinify.dev 免费网页工具,自动化用户可到 https://tinify.dev/developers 免费获取密钥。

限制:单图限 40 MB 和 50 百万像素,结果两小时后过期;支持 AVIF、WebP、JPEG、PNG(GIF 见于网页工具与匿名端点)。免费 API 每月 500 次成功操作,失败调用不计费。lossless 不适用于 JPEG,且不能与 target_size_bytes 同用。错误采用统一格式,仅在 429/503 时按 Retry-After 重试。不要静默覆盖源文件,应报告每个文件的处理前后字节数与总节省量;批量处理时建议分批,并在认证或配额错误时明确失败。转换为更小格式可能反而增大文件,需比较字节并按用户实际需求选择。