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 seedance2Generate a video for each of these 5 product photos, 9:16 ratio for Instagram ReelsCreate a voiceover for this ad script, then generate a sound effect of applause2. 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 appInstallation
Claude Code (community marketplace)
claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install runway-api-skills@claude-communityYou 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/skillsSelect 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_SECRETenv 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 oceanGenerate an image of a red door in a white wallCreate a voiceover saying "Welcome to our store" and save it as welcome.mp3Integrate into a project
Set up Runway video generation in my Next.js appAdd an endpoint to generate videos from text promptsSupported 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
- Base URL:
https://api.dev.runwayml.com - Auth header:
Authorization: Bearer <RUNWAYML_API_SECRET> - Version header:
X-Runway-Version: 2024-11-06 - Official docs: docs.dev.runwayml.com
- API Reference: docs.dev.runwayml.com/api
- Developer portal: dev.runwayml.com