面向生产环境
图像优化 API
通过一次同步 API 请求压缩、调整大小并转换图像。仅成功处理的图像消耗额度。
同步且简单
默认 store=none 在同步响应中返回图片字节,不持久存储源图片或输出图片。
store=temp / store=cdn
store=temp 仅存储优化结果,并返回含有效期为 2 小时的下载链接的 JSON。链接到期与物理删除不同;物理删除遵循存储生命周期清理,不保证固定删除期限。 store=cdn 返回含公开 URL 的 JSON,仅存储优化结果,直至用户删除、依据条款移除或进行套餐或订阅生命周期清理。
额度清晰可控
每张成功处理的图像消耗一个额度。验证、解码或处理失败不消耗额度。
一个端点,实用控制
- 支持 JPEG、PNG、WebP、HEIC 和 HEIF 输入。
- 支持 JPEG、PNG、WebP 或 AVIF 输出,不输出 HEIC。
- 支持控制质量、最大宽度、最大高度和元数据。
- 安全限制为 20 MB、2500 万像素、单帧和 30 秒。
- 可通过可选的 Idempotency-Key 请求头进行幂等重试。
curl -X POST "$API_URL/v1/images/optimize" \
-H "Authorization: Bearer oyi_live_..." \
-H "Idempotency-Key: upload-123" \
-F "[email protected]" \
-F "output_format=webp" \
-F "quality=80" \
--output photo.webp每月免费 500 个额度
未订阅的账户每月可获得 500 个免费额度,另加一次性 100 个欢迎额度。无需银行卡。成功处理一张图片消耗一个额度;失败请求不收费。
创建免费 API 账户