跳到主要内容
smallPict
免费开始
首页框架集成Ruby & Rails Gem

面向 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
)

集成接入步骤

  1. 添加至 Gemfile

    在 Gemfile 中添加 gem 'smallpict' 并运行 bundle install。

  2. 配置 Initializer

    在 config/initializers/smallpict.rb 中配置 API 密钥和默认格式。

  3. 处理附件

    在持久化到云存储前对 ActiveStorage 附件调用 smallpict_optimize。

核心优势与收益

  • 支持 ActiveStorage
  • 支持 Sidekiq 与 GoodJob 异步任务适配器
  • 网络偶发抖动时的自动回退保护机制
  • 在生成现代格式的同时完好保存原始原图

需要完整的开发指南与 API 规范?

在官方 Ruby & Rails Gem 开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。

查阅 Ruby & Rails Gem 完整文档

加速您的 Ruby & Rails Gem 图片处理流程

在您的应用中试用 AVIF 与 WebP 图片优化。无入网费,立即获取沙箱密钥。