Labsco
runwayml logo

rw-recipe-full-setup

★ 55

by runwayml · part of runwayml/skills

Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints

🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys
#automation#ai-video#voice#cloud#git
🧩 One of 7 skills in the runwayml/skills package — works on its own, and pairs well with its siblings.

Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by runwayml

Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints npx skills add https://github.com/runwayml/skills --skill rw-recipe-full-setup Download ZIPGitHub55

Workflow

Phase 1: Compatibility Check

Use +rw-check-compatibility to analyze the user's project.

  • Identify the project type (Node.js, Python, etc.)

  • Verify server-side capability

  • Check runtime version compatibility

  • Look for existing Runway SDK installation

If the project is INCOMPATIBLE, stop and explain the options:

  • Add a backend (Express, FastAPI, etc.)

  • Use a fullstack framework (Next.js, SvelteKit, Nuxt, Remix)

  • Add serverless functions (Vercel Functions, AWS Lambda)

  • Create a separate backend service

If NEEDS CHANGES, help the user make the required changes before proceeding.

If COMPATIBLE, proceed to Phase 2.

Phase 2: API Key Setup

Use +rw-setup-api-key to configure credentials.

  • Direct the user to https://dev.runwayml.com/ to create an account and API key

  • Install the appropriate SDK (@runwayml/sdk for Node.js, runwayml for Python)

  • Configure the RUNWAYML_API_SECRET environment variable

  • Update .gitignore to exclude .env

  • Remind about credit purchase requirement ($10 minimum)

Wait for the user to confirm they have their API key before proceeding.

Phase 3: Determine What to Integrate

Ask the user what they want to build. Based on their response, use the appropriate integration skill:

User wants... Skill to use Generate videos from text +rw-integrate-video (text-to-video) Animate images into video +rw-integrate-video (image-to-video) + +rw-integrate-uploads if local files Edit/transform existing videos +rw-integrate-video (video-to-video) + +rw-integrate-uploads Generate images from text +rw-integrate-image Generate images with references +rw-integrate-image + +rw-integrate-uploads if local refs Text-to-speech +rw-integrate-audio Sound effects +rw-integrate-audio Voice isolation/dubbing +rw-integrate-audio + +rw-integrate-uploads Real-time conversational avatar +rw-integrate-characters + +rw-integrate-character-embed (React UI) Avatar with domain knowledge +rw-integrate-characters + +rw-integrate-documents + +rw-integrate-character-embed Multiple capabilities Integrate each one, sharing the same client instance

Phase 4: Write the Integration Code

Based on the user's framework and needs:

  • Create the API route/handler — server-side endpoint that calls Runway

  • Add upload handling if the user needs to accept files from their users

  • Add error handling — catch and handle task failures

  • Handle output storage — remind user that output URLs expire in 24-48 hours

Phase 5: Test and Verify

Help the user:

  • Run a test generation to verify everything works

  • Check for common issues (missing env var, insufficient credits, wrong model)

  • Confirm output is accessible