crmne · decaffeinatedio · Apr 6, 2026
diff --git a/.gitignore b/.gitignore
@@ -11,6 +11,7 @@
 /tmp/
 .rspec_status*
 .test_queue_stats
+.idea
 
 # Used by dotenv library to load environment variables.
 .env

diff --git a/docs/_core_features/moderation.md b/docs/_core_features/moderation.md
@@ -118,6 +118,11 @@ result = RubyLLM.moderate(
   provider: "openai",
   assume_model_exists: true
 )
+
+# Using an image
+result = RubyLLM.moderate(
+  image: "https://upload.wikimedia.org/wikipedia/en/7/7d/Lenna_%28test_image%29.png"
+)
 ```
 
 ## Choosing Models

diff --git a/lib/ruby_llm/moderation.rb b/lib/ruby_llm/moderation.rb
@@ -12,18 +12,22 @@ def initialize(id:, model:, results:)
       @results = results
     end
 
-    def self.moderate(input,
+    def self.moderate(input = nil,
                       model: nil,
+                      image: nil,
                       provider: nil,
                       assume_model_exists: false,
                       context: nil)
+      raise ArgumentError, 'must provide input text, image, or both' if input.nil? && image.nil?
+
       config = context&.config || RubyLLM.config
       model ||= config.default_moderation_model || 'omni-moderation-latest'
       model, provider_instance = Models.resolve(model, provider: provider, assume_exists: assume_model_exists,
                                                        config: config)
       model_id = model.id
+      image = Attachment.new(image) if image
 
-      provider_instance.moderate(input, model: model_id)
+      provider_instance.moderate(input, model: model_id, image: image)
     end
 
     # Convenience method to get content from moderation result

diff --git a/lib/ruby_llm/provider.rb b/lib/ruby_llm/provider.rb
@@ -75,8 +75,8 @@ def embed(text, model:, dimensions:)
       parse_embedding_response(response, model:, text:)
     end
 
-    def moderate(input, model:)
-      payload = render_moderation_payload(input, model:)
+    def moderate(input, model:, image: nil)
+      payload = render_moderation_payload(input, model:, image:)
       response = @connection.post moderation_url, payload
       parse_moderation_response(response, model:)
     end

diff --git a/lib/ruby_llm/providers/openai/moderation.rb b/lib/ruby_llm/providers/openai/moderation.rb
@@ -11,11 +11,17 @@ def moderation_url
           'moderations'
         end
 
-        def render_moderation_payload(input, model:)
-          {
-            model: model,
-            input: input
-          }
+        def render_moderation_payload(input, model:, image: nil)
+          mod_input = if image
+                        parts = []
+                        parts << { type: 'text', text: input } if input
+                        parts << Media.format_image(image)
+                        parts
+                      else
+                        input
+                      end
+
+          { model: model, input: mod_input }
         end
 
         def parse_moderation_response(response, model:)

diff --git a/...r_cassettes/activerecord_actsas_attachment_handling_handles_attachments_in_ask_method.yml b/...r_cassettes/activerecord_actsas_attachment_handling_handles_attachments_in_ask_method.yml
diff --git a/...es/vcr_cassettes/activerecord_actsas_attachment_handling_handles_multiple_attachments.yml b/...es/vcr_cassettes/activerecord_actsas_attachment_handling_handles_multiple_attachments.yml
diff --git a/...ures/vcr_cassettes/activerecord_actsas_basic_chat_functionality_persists_chat_history.yml b/...ures/vcr_cassettes/activerecord_actsas_basic_chat_functionality_persists_chat_history.yml
diff --git a/...ixtures/vcr_cassettes/activerecord_actsas_basic_chat_functionality_tracks_token_usage.yml b/...ixtures/vcr_cassettes/activerecord_actsas_basic_chat_functionality_tracks_token_usage.yml
diff --git a/...tiverecord_actsas_custom_configurations_namespaced_chat_models_allows_model_switching.yml b/...tiverecord_actsas_custom_configurations_namespaced_chat_models_allows_model_switching.yml
diff --git a/..._custom_configurations_namespaced_chat_models_persists_tool_calls_with_custom_classes.yml b/..._custom_configurations_namespaced_chat_models_persists_tool_calls_with_custom_classes.yml
diff --git a/...urations_namespaced_chat_models_works_with_namespaced_classes_and_custom_associations.yml b/...urations_namespaced_chat_models_works_with_namespaced_classes_and_custom_associations.yml
diff --git a/...ssettes/activerecord_actsas_default_model_uses_config_default_when_no_model_specified.yml b/...ssettes/activerecord_actsas_default_model_uses_config_default_when_no_model_specified.yml
diff --git a/...s/activerecord_actsas_event_callbacks_calls_on_tool_call_and_on_tool_result_callbacks.yml b/...s/activerecord_actsas_event_callbacks_calls_on_tool_call_and_on_tool_result_callbacks.yml
diff --git a/...verecord_actsas_event_callbacks_preserves_user_callbacks_when_using_rails_integration.yml b/...verecord_actsas_event_callbacks_preserves_user_callbacks_when_using_rails_integration.yml
diff --git a/...hinking_persistence_openai_gpt-5_4_persists_thinking_data_and_replays_it_across_turns.yml b/...hinking_persistence_openai_gpt-5_4_persists_thinking_data_and_replays_it_across_turns.yml
diff --git a/...s_model_associations_when_model_registry_is_configured_associates_messages_with_model.yml b/...s_model_associations_when_model_registry_is_configured_associates_messages_with_model.yml
diff --git a/...cassettes/activerecord_actsas_model_switching_allows_changing_models_mid-conversation.yml b/...cassettes/activerecord_actsas_model_switching_allows_changing_models_mid-conversation.yml
diff --git a/..._actsas_structured_output_supports_multi-turn_conversations_with_structured_responses.yml b/..._actsas_structured_output_supports_multi-turn_conversations_with_structured_responses.yml
diff --git a/...s/activerecord_actsas_structured_output_supports_with_schema_for_structured_responses.yml b/...s/activerecord_actsas_structured_output_supports_with_schema_for_structured_responses.yml
diff --git a/.../vcr_cassettes/activerecord_actsas_tool_functionality_handles_halt_mechanism_in_tools.yml b/.../vcr_cassettes/activerecord_actsas_tool_functionality_handles_halt_mechanism_in_tools.yml
diff --git a/spec/fixtures/vcr_cassettes/activerecord_actsas_tool_usage_persists_tool_calls.yml b/spec/fixtures/vcr_cassettes/activerecord_actsas_tool_usage_persists_tool_calls.yml
diff --git a/...ettes/chat_assume_model_exists_works_with_models_not_in_registry_but_available_in_api.yml b/...ettes/chat_assume_model_exists_works_with_models_not_in_registry_but_available_in_api.yml
diff --git a/...vcr_cassettes/chat_audio_models_openai_gpt-4o-mini-audio-preview_can_understand_audio.yml b/...vcr_cassettes/chat_audio_models_openai_gpt-4o-mini-audio-preview_can_understand_audio.yml
diff --git a/...cassettes/chat_audio_models_openai_gpt-4o-mini-audio-preview_can_understand_mp3_audio.yml b/...cassettes/chat_audio_models_openai_gpt-4o-mini-audio-preview_can_understand_mp3_audio.yml
diff --git a/...s/chat_basic_chat_functionality_openai_gpt-5-nano_can_handle_multi-turn_conversations.yml b/...s/chat_basic_chat_functionality_openai_gpt-5-nano_can_handle_multi-turn_conversations.yml
diff --git a/...ssettes/chat_basic_chat_functionality_openai_gpt-5-nano_can_have_a_basic_conversation.yml b/...ssettes/chat_basic_chat_functionality_openai_gpt-5-nano_can_have_a_basic_conversation.yml
diff --git a/...t_functionality_openai_gpt-5-nano_replaces_previous_system_messages_when_replace_true.yml b/...t_functionality_openai_gpt-5-nano_replaces_previous_system_messages_when_replace_true.yml
diff --git a/...s/vcr_cassettes/chat_basic_chat_functionality_openai_gpt-5-nano_returns_raw_responses.yml b/...s/vcr_cassettes/chat_basic_chat_functionality_openai_gpt-5-nano_returns_raw_responses.yml
diff --git a/...s/chat_basic_chat_functionality_openai_gpt-5-nano_successfully_uses_the_system_prompt.yml b/...s/chat_basic_chat_functionality_openai_gpt-5-nano_successfully_uses_the_system_prompt.yml
diff --git a/...ontent_object_support_openai_gpt-5-nano_preserves_content_objects_returned_from_tools.yml b/...ontent_object_support_openai_gpt-5-nano_preserves_content_objects_returned_from_tools.yml
diff --git a/.../fixtures/vcr_cassettes/chat_error_handling_raises_an_error_when_tool_execution_fails.yml b/.../fixtures/vcr_cassettes/chat_error_handling_raises_an_error_when_tool_execution_fails.yml
-Original file line number
+Diff line change
@@ Expand Up / @@ -11,6 +11,7 @@ @@
     /tmp/
     .rspec_status*
     .test_queue_stats
+    .idea
     # Used by dotenv library to load environment variables.
     .env
@@ Expand Down @@