SuperAPI AI 工具集

netlify-image-cdn

设计与创作

查看项目

更新于 10-16 03:47

技能介绍

用途:通过请求 Netlify 内置边缘端点 /.netlify/images 按需转换图片,无需编写函数或文件。

主要能力:支持 url(必填,相对路径或完整远程 URL)、w、h、fit(contain 默认、cover、fill)、position(仅 fit=cover 时生效)、fm(avif、jpg、png、webp、gif、blurhash)、q(1–100,默认 75)。fit=cover 必须同时提供 w 和 h;contain 只给一个维度会按比例计算另一个。未指定 fm 时按浏览器 Accept 头返回 webp 或 avif,否则原格式。fm=blurhash 返回文本字符串而非图片字节,需提前获取并在客户端用 BlurHash 库解码,再单独请求真实图片。

使用方式:示例 curl 'https://mysitename.netlify.app/.netlify/images?url=/owl.jpeg&fit=cover&w=50&h=50&position=left&fm=webp&q=80'。远程图片需在 netlify.toml 的 [images] remote_images 中允许域名,并用 encodeURIComponent 编码 URL。可用 _redirects 或 netlify.toml 重定向复用转换参数。源图上的 Cache-Control 头会应用到转换结果。本地用 netlify dev 测试,出现 404 通常是因为运行了框架开发服务器而非 netlify dev。

适用场景:响应式图片、远程图片代理、框架图片组件(Angular、Astro、Nuxt、Next.js、Gatsby)集成。

限制:不支持 Split Testing;不支持 HIPAA 合规托管;远程源必须公开可访问,不转发 Authorization 或 Cookie 头;自定义头不能应用于远程源图。其余细节暂未提供。