Ruby & Rails SDK

官方 smallpict gem，适用于 Ruby on Rails, Sinatra 与 Sidekiq 后台任务环境。

SmallPict 官方 Ruby gem 为 Ruby 3.0+ 及 Ruby on Rails 框架提供地道的图像优化支持。

安装方式

Shell

gem install smallpict# 或在 Gemfile 中添加gem 'smallpict', '~> 0.0.2'

快速上手示例

Ruby

require 'smallpict'
client = SmallPict::Client.new(  api_key: ENV['SMALLPICT_API_KEY'],  secret_key: ENV['SMALLPICT_SECRET_KEY'])
# 1. 优化本地图片文件result = client.optimize(  'hero.jpg',  format: 'avif',  quality: 80)
puts "优化后 URL: #{result.url}"puts "节约比例: #{result.savings_percentage}%"
# 2. 检查配额消耗quota = client.get_quotaputs "当前套餐: #{quota.plan}, 已使用: #{quota.quota_percentage}%"
# 3. 刷新 CDN 缓存client.purge_cdn(['https://cdn.smallpict.app/opt/hero.avif'])

Rails ActiveStorage 适配器集成

SmallPict 内置了原生 ActiveStorage 服务适配器：

Ruby

# config/initializers/smallpict.rbSmallPict.configure do |config|  config.api_key    = Rails.application.credentials.dig(:smallpict, :api_key)  config.secret_key = Rails.application.credentials.dig(:smallpict, :secret_key)end