公式インテグレーション＆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. イニシャライザの設定
config/initializers/smallpict.rb を作成し、API キーを設定します。
33. 添付ファイルの処理
クラウドに保存する前に ActiveStorage 添付ファイルで smallpict_optimize を呼び出します。
主なメリット
- ActiveStorage とのネイティブ連携で設定の手間がゼロ
- Sidekiq および GoodJob バックグラウンドワーカー対応
- ネットワーク障害時の自動フォールバック保護
- 元画像マスターファイルを最新フォーマットと並行して保持
公式開発者ドキュメント
完全な実装ガイドと API 仕様をお探しですか？
公式 Ruby & Rails Gem 開発者ガイドで、パラメータ仕様、認証、エラーコード、ローカル検証手順をご確認いただけます。
Ruby & Rails Gem の画像パイプラインを最大化
アプリケーションで 50ms 未満の高速 AVIF / WebP 配信を実現。初期費用なし、即時利用可能なサンドボックスキーを提供。