Ruby & Rails SDK

Ruby on Rails、Sinatra、Sidekiq環境向け公式 smallpict gem。

公式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