openrouter-video-generator

Generate short MP4 video assets through the OpenRouter async video API.

6.8k|540|Updated May 6, 2026
One-click install
npx skills add https://github.com/opensquilla/opensquilla --skill openrouter-video-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openrouter-video-generator
Source: https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/openrouter-video-generator
Command: npx skills add https://github.com/opensquilla/opensquilla --skill openrouter-video-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Web pages built by the AwesomeWebpageMetaSkill often need short, browser-playable video clips, but calling OpenRouter video models incorrectly (for example via the chat-completions endpoint) wastes budget and fails. This Skill provides a deterministic adapter that submits, polls, downloads, and validates video jobs correctly.

Core Features & Use Cases

  • Async Video Job Handling: Submits prompts to the OpenRouter /videos endpoint, polls the job status, and downloads the finished MP4.
  • Secure Credential Leasing: Receives a short-lived Provider Settings connection inside the child process so API keys never appear in arguments, plans, or persisted run data.
  • Structured Success and Failure Labels: Emits a VIDEO_READY manifest line on success or explicit labels like VIDEO_CONFIG_NEEDED and VIDEO_GENERATION_FAILED with a replacement slot on failure.
  • Use Case: While generating a landing page, the meta-skill needs a 10-second intro clip; it runs this Skill with a prompt and receives a validated MP4 saved under project/assets/video/.

Quick Start

Ask the agent to generate a short intro video for the webpage using the configured OpenRouter video model and save it under the project assets video directory.

Frequently Asked Questions about openrouter-video-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a video with the OpenRouter API?

Submit a POST request to the /videos endpoint with the model, prompt, and duration, then poll the returned polling_url until the status is completed. Download the first URL from unsigned_urls and save it as an MP4 file.

Why does calling a video model through chat completions fail?

OpenRouter video models are exposed only through an async job endpoint, not chat completions. Sending a video model id to /chat/completions returns HTTP 500 and consumes the per-attempt budget without producing a video.

How long does OpenRouter video generation take?

A typical short clip completes in 60 to 120 seconds. The polling loop should run every 8 to 15 seconds and be capped at about 5 minutes per clip before treating the job as failed.

What happens when video generation fails in this Skill?

The Skill emits a single-line failure label such as VIDEO_CONFIG_NEEDED, VIDEO_MODEL_UNSUPPORTED, or VIDEO_GENERATION_FAILED along with a replacement slot path. Downstream packaging can then render a placeholder instead of retrying automatically.

Does the OpenRouter API key appear in skill arguments or logs?

No. During a MetaSkill run the credential, endpoint, and proxy arrive through a short-lived lease via environment variables in the child process only, and never enter arguments, the plan, or persisted run data.