官方原生集成与 SDK
面向 Ruby on Rails 与 ActiveStorage 的便捷图片处理
使用官方 Gem 加速 Rails 图片上传。与 ActiveStorage 变体和 Sidekiq 异步任务天然互补。
安装命令:
RUBY 软件包gem install smallpict-ruby代码接入示例
ruby# Gemfile
gem 'smallpict-ruby'
# config/initializers/smallpict.rb
SmallPict.configure do |config|
config.api_key = ENV['SMALLPICT_API_KEY']
config.auto_format = :auto # Selects AVIF or WebP based on client
config.quality = 82
end
# In your Controller / Service:
optimized_url = SmallPict.optimize(
user.avatar.url,
width: 400,
format: :avif
)集成接入步骤
11. 添加至 Gemfile
在 Gemfile 中添加 gem 'smallpict' 并运行 bundle install。
22. 配置 Initializer
在 config/initializers/smallpict.rb 中配置 API 密钥和默认格式。
33. 处理附件
在持久化到云存储前对 ActiveStorage 附件调用 smallpict_optimize。
核心优势与收益
- 原生 ActiveStorage 集成，零额外侵入
- 支持 Sidekiq 与 GoodJob 异步任务适配器
- 网络偶发抖动时的自动回退保护机制
- 在生成现代格式的同时完好保存原始原图
官方开发者技术文档
需要完整的开发指南与 API 规范？
在官方 Ruby & Rails Gem 开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。
全面加速您的 Ruby & Rails Gem 图像管线
在您的应用中体验低于 50 毫秒的极速 AVIF 与 WebP 转换。零入网费，即刻获取沙箱 API Key，支持弹性扩展。