Accept video attachments in OpenRouter chats

Author: crmne

lib/ruby_llm/providers/openrouter/chat.rb

@@ -12,6 +12,10 @@ module Chat
 
         module_function
 
+        def format_content(content, attachments = [])
+          OpenRouter::Media.format_content(content, attachments)
+        end
+
         def render_payload(messages, tools:, temperature:, model:, stream: false, max_output_tokens: nil, schema: nil,
                            thinking: nil, citations: false, caching: nil, tool_prefs: nil)
           payload = super

lib/ruby_llm/providers/openrouter/media.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Providers
+    class OpenRouter
+      # Handles media content for OpenRouter, which adds video input parts
+      # to the standard Chat Completions vocabulary.
+      module Media
+        module_function
+
+        def format_content(content, attachments = [])
+          Protocols::ChatCompletions::Media.format_parts(content, attachments) do |attachment|
+            if attachment.type == :video
+              format_video(attachment)
+            else
+              Protocols::ChatCompletions::Media.format_attachment(
+                attachment, document_attachments: :pdf, image_attachments: true, audio_attachments: true
+              )
+            end
+          end
+        end
+
+        def format_video(video)
+          {
+            type: 'video_url',
+            video_url: {
+              url: video.url? ? video.source.to_s : video.for_llm
+            }
+          }
+        end
+      end
+    end
+  end
+end

spec/ruby_llm/providers/openrouter/media_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+RSpec.describe RubyLLM::Providers::OpenRouter::Media do
+  include_context 'with configured RubyLLM'
+
+  it 'formats video attachments as video_url parts' do
+    chat = RubyLLM.chat(model: 'openai/gpt-5.2', provider: :openrouter)
+    chat.add_message(role: :user, content: 'what happens here?', attachments: 'https://example.com/clip.mp4')
+
+    part = chat.render[:messages].first[:content].find { |p| p[:type] == 'video_url' }
+
+    expect(part).to eq(type: 'video_url', video_url: { url: 'https://example.com/clip.mp4' })
+  end
+end