Skip to content

runwayml/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Runway API Skills

Video generation at scale. Generate videos, images, and audio with Runway's API — batch Ad campaigns, product videos, multishot stories, and creative iteration. Supports seedance2, gen4.5, veo3, Nano, Banana Pro, and more.

Works with Claude Code, Cursor, Codex, and other compatible agents.

Two Ways to Use

1. Generate media at scale

Tell your agent what to create and it handles the rest — calls the API, polls for completion, downloads the result. Generate one asset or orchestrate hundreds.

Generate a 15-second product video from this image using seedance2
Generate a video for each of these 5 product photos, 9:16 ratio for Instagram Reels
Create a voiceover for this ad script, then generate a sound effect of applause

2. Integrate into your app

Guide your agent through adding Runway capabilities to a server-side project: verify compatibility, set up credentials, write framework-specific routes, and handle edge cases like file uploads and task polling.

Set up Runway video generation in my Next.js app

Installation

Claude Code (community marketplace)

claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install runway-api-skills@claude-community

You can also run /plugin in Claude Code, open Discover, search for runway-api-skills, and install from there. After installing or updating plugins, run /reload-plugins if skills do not appear immediately.

Other agents (npx skills)

npx skills add runwayml/skills

Select all the skills with your keyboard (Space to select, arrow keys to navigate), then press Enter to install.

Prerequisites

  • A Runway developer account with prepaid credits ($10 minimum)
  • For generation skills: uv (Python package runner) and RUNWAYML_API_SECRET env var
  • For integration skills: a server-side project — Node.js 18+ or Python 3.8+ with a backend framework

Available Skills

Generation (run directly)

Generate media assets directly — your agent runs the scripts, polls for completion, and saves the output.

Skill Description
rw-generate-video Generate videos: text-to-video, image-to-video, video-to-video
rw-generate-image Generate images: text-to-image with optional reference images
rw-generate-audio Generate audio: TTS, sound effects, voice isolation, dubbing, voice conversion

Integration (add to your app)

Add Runway generation to your server-side project with framework-specific code.

Skill Description
rw-integrate-video Text-to-video, image-to-video, video-to-video, and character performance generation
rw-integrate-image Text-to-image generation with optional reference images via @Tag syntax
rw-integrate-audio Text-to-speech, sound effects, voice isolation, dubbing, and speech-to-speech

Getting Started

Skill Description
rw-recipe-full-setup End-to-end setup: compatibility check → API key → SDK install → integration code → test
rw-check-compatibility Analyze your project to verify it can safely call the Runway API server-side
rw-setup-api-key Guide through account creation, SDK installation, and environment variable configuration
rw-check-org-details Query your organization's rate limits, credit balance, usage tier, and daily generation counts

Characters (Real-Time Avatars)

Skill Description
rw-integrate-characters Create GWM-1 avatars and set up server-side session management for real-time conversations
rw-integrate-character-embed Embed avatar call UI in React apps using @runwayml/avatars-react
rw-integrate-documents Add knowledge base documents to avatars for domain-specific conversations

Utilities

Skill Description
use-runway-api Call any public API endpoint to manage resources, trigger generations, and inspect state
rw-integrate-uploads Upload local files to get runway:// URIs for use as generation inputs
rw-api-reference Complete API reference — models, endpoints, costs, rate limits, and error codes
rw-fetch-api-reference Fetch the latest API docs from docs.dev.runwayml.com/api as the source of truth

Supported Models

Video

Model Use Case Cost
seedance2 Reference image and video, long duration 36 credits/sec
gen4.5 High quality, general purpose 12 credits/sec
gen4_turbo Fast, image-driven (image required) 5 credits/sec
gen4_aleph Video-to-video editing 15 credits/sec
veo3 Premium quality 40 credits/sec
veo3.1 / veo3.1_fast High quality / fast Google models 10–40 credits/sec

Image

Model Cost
gen4_image 5–8 credits
gen4_image_turbo 2 credits
gemini_2.5_flash 5 credits

Audio

Model Use Case
eleven_multilingual_v2 Text-to-speech
eleven_text_to_sound_v2 Sound effects
eleven_voice_isolation Isolate voice from audio
eleven_voice_dubbing Dub audio to other languages
eleven_multilingual_sts_v2 Voice conversion

Characters

Model Description
gwm1_avatars Real-time conversational avatars (5-min max session)

Quick Start

Generate media directly

Generate a 10-second video of a sunset over the ocean
Generate an image of a red door in a white wall
Create a voiceover saying "Welcome to our store" and save it as welcome.mp3

Integrate into a project

Set up Runway video generation in my Next.js app
Add an endpoint to generate videos from text prompts

Supported Frameworks

The integration skills generate framework-specific code for:

  • Node.js — Express, Fastify, Next.js (App Router & Pages Router), Remix, SvelteKit, Nuxt, Astro
  • Python — FastAPI, Flask, Django
  • Serverless — Vercel Functions, AWS Lambda, Cloudflare Workers

API Reference

License

MIT

About

for Runway coding agent skills

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors