gitwtfhub

wtf is openwebui-openrouter-video?

spawnofsociety2/openwebui-openrouter-video — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

This OpenWebUI tool lets a chat assistant autonomously pick a video AI model on OpenRouter, generate a video from a plain-language request, and embed the finished clip directly in the chat.

Mindmap

mindmap
  root((openrouter video tool))
    What it does
      LLM-driven video generation
      Live model discovery
      Auto-download and embed
      Chat-native player
    Tech stack
      Python
      aiohttp
      OpenWebUI
      OpenRouter
    Use cases
      Text to video in chat
      4K cinematic clips
      Style reference images
    Requirements
      Existing OpenWebUI instance
      OpenRouter API key
      Manual disk cleanup

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Ask an OpenWebUI chat assistant to generate a short AI video from a text description without picking a model manually.

REASON 2

Generate a 4K cinematic video clip using a model like Veo 3.1 by describing the shot in natural language.

REASON 3

Use a reference image to guide the visual style of an AI-generated video within a chat conversation.

What's in the stack?

PythonaiohttpOpenWebUIOpenRouter

How it stacks up

spawnofsociety2/openwebui-openrouter-video1038lab/agnes-aiadeliox/klein-head-swap
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedevelopervibe coderdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires an existing OpenWebUI instance and an OpenRouter API key, downloaded videos are never auto-deleted.

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

Wtf does this do

This project is a tool that adds AI video generation to OpenWebUI, a self-hosted chat interface for talking to language models. Once installed, a user's chat assistant can generate short AI videos just by being asked in plain language, without clicking through menus or picking a model manually. The assistant itself decides which video model to use, submits the generation job to OpenRouter, checks on it until it finishes, and then shows the finished video directly inside the chat. The tool pulls its list of available video models live from OpenRouter at the moment it is used, so it automatically supports new models like Sora, Veo, Kling, Seedance, Hailuo, Wan, and Grok as OpenRouter adds them, along with each model's supported resolutions, durations, aspect ratios, and pricing. Once a video finishes generating, the tool downloads the file to the OpenWebUI server itself rather than linking to a temporary URL, which avoids broken links after the original link expires, and embeds it in the chat with a working video player and download link. More advanced options include turning audio on or off where a given model supports it, using a fixed seed for repeatable results, and passing a reference image to guide the video's style. The README is notably careful about how audio behaves differently across models, since some models silently ignore the audio setting and produce sound anyway. Installing the tool means pasting a single Python file into OpenWebUI's tool editor and adding an OpenRouter API key in the tool's settings, a few optional settings control how long the tool waits for a video to finish before giving up. The project depends on the aiohttp Python library, which OpenWebUI installs automatically, and requires an existing OpenWebUI instance to run inside. One notable limitation mentioned in the README is that downloaded videos are never deleted automatically, so a long-running installation that generates many videos will need someone to periodically clear out old files. The project is released under the MIT license.

Yoink these prompts

Prompt 1
What video models can I use right now, and which ones support audio?
Prompt 2
Use Grok to generate a 5-second video of a fluffy ginger cat watching the rain, aspect ratio 16:9.
Prompt 3
Use Veo 3.1 to make an 8-second 4K cinematic drone shot over a misty mountain range.
Prompt 4
How do I set an OpenRouter API key for this tool inside OpenWebUI's settings?

Frequently asked questions

wtf is openwebui-openrouter-video?

This OpenWebUI tool lets a chat assistant autonomously pick a video AI model on OpenRouter, generate a video from a plain-language request, and embed the finished clip directly in the chat.

What language is openwebui-openrouter-video written in?

Mainly Python. The stack also includes Python, aiohttp, OpenWebUI.

What license does openwebui-openrouter-video use?

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

How hard is openwebui-openrouter-video to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is openwebui-openrouter-video for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.