开发者接口参考
基于 SmallPict API 极速构建。
将企业级图像处理能力接入您的系统。单个高性能端点即可完成海量媒体资源的压缩、格式转换与弹性缩放。
快速上手指南
01
注册开发者账号
注册免费开发者账号，即刻获取每月基础测试配额。
02
生成 API 秘钥
进入控制台创建生产环境或 WordPress 专属的作用域 API Key。
03
发起首次图像优化
通过 POST 发送图像公网 URL 或二进制数据，亚毫秒级获取优化后的 AVIF 或 WebP 资源。
HMAC-SHA256 签名鉴权
所有接口请求必须附带 HMAC-SHA256 签名，坚决杜绝未授权访问与重放攻击。
请求头生效中
Authorization: Bearer sp_sdk_...交互式代码演练场
查看核心端点的真实请求格式、参数结构与 JSON 返回示例。
REST API 99.99% 正常运行时间
POST
/v1/optimize智能无损或有损量化至 AVIF/WebP 格式，支持客户端自动协商。
- WebP 与 AVIF 转码
- 自动剥离 EXIF 元数据
POST
/v1/convert在 PNG、JPG、WebP 及 AVIF 格式之间直接转码。
- 保留 Alpha 透明通道
- 支持 ICC 颜色配置文件
POST
/v1/resize支持智能尺寸约束的响应式缩略图与横幅生成。
- 宽度与高度自适应缩放
- 完美保持原始宽高比
curl -X POST https://api.smallpict.app/v1/optimize \
-H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \
-H "X-Timestamp: 1716301234" \
-H "X-Signature: 3a9f8b2c4d6e..." \
-H "Content-Type: application/json" \
-d '{
"filename": "hero.jpg",
"mime_type": "image/jpeg",
"filesize": 2508800,
"options": {
"format": "avif",
"quality": 80,
"max_width": 800
}
}'转换参数配置