快速上手指南
不到 2 分钟即可完成调试- 01
注册开发者账号
注册免费开发者账号,即刻获取每月基础测试配额。
- 02
生成 API 秘钥
进入控制台创建生产环境或 WordPress 专属的作用域 API Key。
- 03
发起首次图像优化
通过 POST 发送图像公网 URL 或二进制数据,亚毫秒级获取优化后的 AVIF 或 WebP 资源。
HMAC-SHA256 签名鉴权
所有接口请求必须附带 HMAC-SHA256 签名,坚决杜绝未授权访问与重放攻击。
请求头
X-API-Key: sp_sdk_9a8b7c6d5e4f...
X-Timestamp: 1716301234
X-Signature: HMAC-SHA256(method + path + timestamp + sha256(body))交互式代码演练场
查看核心端点的真实请求格式、参数结构与 JSON 返回示例。
POST/v1/optimize
无损或有损转换为 AVIF 或 WebP,每个请求可单独选择格式。
- WebP 与 AVIF 转码
- 自动剥离 EXIF 元数据
POST/v1/convert
在 PNG、JPG、WebP 及 AVIF 格式之间直接转码。
- 保留 Alpha 透明通道
- 支持 ICC 颜色配置文件
POST/v1/resize
在您设定的尺寸范围内生成响应式缩略图和横幅。
- 宽度与高度自适应缩放
- 完美保持原始宽高比
cURL
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
}
}'转换参数配置
准备好开始技术接入了吗?
数秒内获取您的专属 API Key,立即以编程方式启动全自动媒体优化流。