API 文档

Image Optimizer

将图像转换为 WebP 和 AVIF，文件大小最多可减少 80%。提供完整的 REST API、WordPress 插件和全球 CDN 交付。

80%

平均节省

50ms

响应时间

20+

CDN 位置

99.9%

正常运行时间服务等级协议

概述

Jetweb Image Optimizer 是一项高性能图像转换服务，可将您的图像转换为现代的 WebP 和 AVIF 格式。我们的 API 可在毫秒级时间内处理图像，并通过全球 CDN 进行交付，实现闪电般的加载速度。

无论您是在构建 WordPress 网站、电子商务平台还是自定义 Web 应用程序，Jetweb 都提供了在任何规模下交付优化图像的工具。

功能特性

WebP 转换

全球 97%+ 的浏览器支持

AVIF 格式

下一代压缩技术（Starter+ 套餐）

批量处理

每个请求最多处理 10 张图像

全球 CDN

全球 20+ 个边缘节点

签名 URL

加密安全交付

WordPress 插件

一键安装

支持的格式

我们支持所有主流图像格式，并采用优化的压缩算法：

输入格式	输出格式	典型节省	最大尺寸
JPEG (.jpg, .jpeg)	WebP, AVIF	50-70%	50 MB
PNG (.png)	WebP, AVIF	60-80%	50 MB
GIF (.gif)	WebP (animated)	40-60%	50 MB
WebP (.webp)	AVIF	20-40%	50 MB
BMP (.bmp)	WebP, AVIF	80-95%	50 MB

WordPress 插件

使用我们的官方 WordPress 插件，几分钟内即可开始使用。无需配置即可自动优化所有媒体上传。

安装

下载插件，从您的 Jetweb 仪表板

上传插件，通过 WordPress 管理后台 → 插件 → 添加新插件 → 上传插件

激活 Jetweb Image Optimizer 插件

配置，在设置 → Jetweb Image Optimizer

输入 API 密钥，从您的 API 密钥页面

插件设置

Setting	Description	Default
API 密钥	您的 Jetweb 访问令牌（以 jw_ 开头）	必填
输出格式	WebP（所有套餐）或 AVIF（Starter+）	WebP
质量	压缩质量 1-100	85
自动优化	上传时优化图像	已启用
使用 CDN	通过 Jetweb CDN 提供	已启用

REST API

使用我们的 REST API 构建自定义集成。所有请求都需要通过 X-Access Token 标头进行身份验证。

身份验证

                headers
                
                X-Access-Token: jw_your_api_key_here
Content-Type: multipart/form-data

转换单个图像

                POST /convert
                
              

                # Request
POST https://image-optimizer.api.jetweb.app/convert

# Form Data
file:    [binary]     # Image file
format:  webp         # webp | avif
quality: 85           # 1-100

# Response Headers
X-Original-Size:  156789
X-Converted-Size: 45678
X-Savings:        71%
X-CDN-URL-WebP:   https://cdn.jetweb.app/abc123.webp?sig=...
              

批量转换

                POST /convert/batch
                
              

                # Request (up to 10 images)
POST https://image-optimizer.api.jetweb.app/convert/batch

files[]: [image1.jpg]
files[]: [image2.png]
format:  webp
quality: 85

# Response
{
  "success": true,
  "results": [
    { "filename": "image1.jpg", "savings": "68%", "cdnUrl": "..." },
    { "filename": "image2.png", "savings": "75%", "cdnUrl": "..." }
  ],
  "totalProcessed": 2
}
              

CDN 集成

所有转换后的图像都会自动存储在我们的全球 CDN 上。直接在您的 HTML 中使用提供的签名 URL：

              usage.html
              
            

              <!-- Modern browsers with fallback -->
<picture>
  <source srcset="https://cdn.jetweb.app/abc.avif?sig=..." type="image/avif">
  <source srcset="https://cdn.jetweb.app/abc.webp?sig=..." type="image/webp">
  <img src="/original.jpg" alt="Description" loading="lazy">
</picture>
            

质量设置

根据您的使用场景选择最佳质量设置：

质量	使用场景	文件大小	视觉质量
90-100	摄影、产品图片	较大	无损/接近无损
80-90	通用网页图片	平衡	优秀（推荐）
60-80	缩略图、背景图	较小	良好
<60	最大压缩	最小	可接受

速率限制与定价

API速率限制和每月配额因套餐而异：

免费

0€/mo

50 张图片/月

WebP only
10 req/min
No CDN

入门版

2,99€/mo

500 张图片/月

WebP + AVIF
30 req/min
CDN included

专业版

5,99€/mo

每月 2,000 张图片

WebP + AVIF
60 req/min
CDN + Priority

商业版

9,99€/mo

每月 10,000 张图片

All formats
120 req/min
Priority support

速率限制标头： X-RateLimit-Remaining, X-RateLimit-Reset

错误代码

API 返回标准的 HTTP 状态码及描述性错误信息：

代码	错误	描述
400	请求无效	参数无效或缺少必填字段
401	未授权	API 密钥缺失或无效
403	禁止访问	超出计划限制或功能不可用
413	负载过大	文件超过 50MB 限制
415	不支持的媒体类型	不支持的文件格式
429	请求过多	超出速率限制
500	服务器错误	内部处理错误

故障排除

"超出月度转换限制"

您已达到您计划的月度配额。升级您的计划或等待下一个计费周期（每月1日重置）。

"访问令牌无效"

请在API 密钥页面验证您的 API 密钥。密钥必须以 jw_ 开头。

"文件过大"

最大文件大小为 50MB。请在上传前调整图像大小或先使用压缩工具。

"超出速率限制"

请等待速率限制窗口重置（重置时间显示在 X-RateLimit-Reset 响应头中）或升级您的计划。

常见问题

WebP 提供出色的压缩率，并拥有 97% 以上的浏览器支持率。AVIF 提供 20-30% 更好的压缩率，但浏览器支持率约为 92%。我们建议为获得最大兼容性使用 WebP，针对现代浏览器时使用 AVIF。

转换后的图像自最后一次访问起存储 30 天。活跃图像（30 天内被访问过）将被无限期保留。签名 URL 的有效期为 1 年。

可以！我们的 REST API 可与任何框架配合使用。对于 Next.js，我们建议在构建期间进行服务器端转换，或直接使用我们的 CDN URL，并对 Jetweb URL 禁用 next/image 优化。

默认情况下，我们会剥离 EXIF 元数据以减小文件大小并保护隐私。在您的请求中添加 preserve_metadata=true 即可保留它。

有！对于高容量需求（每月 50,000+ 张图像），请通过 [email protected] 联系我们，获取定制价格和专属支持。

准备优化了吗？

几分钟内即可开始转换图像。免费计划每月包含 50 张图像。

免费开始联系支持