skilld
All skills
runwayml avatar

/use-runway-api

@82d9fad official
by Runwayrunwayml/skills70 stars
18

Directly use the Runway API from the agent to generate media, manage resources, and inspect account state

Ask your Agent

Use this Skill: https://skilld.dev/gh/runwayml/skills/use-runway-api

This session only. Nothing lands on disk.

AUTH.md

≈412 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Auth Setup

Use environment variables for direct Runway API actions. The API key must never appear in the chat.

Default setup

  1. Open the API keys page: https://dev.runwayml.com/settings/api-keys
  2. Create or copy an API key
  3. Set it in the environment that launches your editor

Current shell before launching the editor:

export RUNWAY_SKILLS_API_SECRET=YOUR_KEY_HERE
cursor .

Or add it to your shell profile, then restart the editor:

echo 'export RUNWAY_SKILLS_API_SECRET=YOUR_KEY_HERE' >> ~/.zshrc
source ~/.zshrc

Replace YOUR_KEY_HERE locally in the terminal. Never paste the key into the chat.

Verify

node <skill-dir>/scripts/runway-api.mjs auth status

<skill-dir> is the absolute directory of the SKILL.md you are reading — see the Runtime Location section in SKILL.md for how to resolve it.

If authenticated is still false, restart the editor or launch it from a shell that already has RUNWAY_SKILLS_API_SECRET set.

Non-production environments

Set a stage-specific key (preferred) and/or override the base URL:

export RUNWAY_SKILLS_API_SECRET_STAGE=YOUR_STAGE_KEY
export RUNWAY_SKILLS_BASE_URL=https://api.dev-stage.runwayml.com

With --stage on any command, the CLI prefers RUNWAY_SKILLS_API_SECRET_STAGE and falls back to RUNWAY_SKILLS_API_SECRET.

Notes

  • API keys require prepaid credits to work.
  • RUNWAY_SKILLS_BASE_URL defaults to https://api.dev.runwayml.com (production) or https://api.dev-stage.runwayml.com when --stage is passed.
  • auth status verifies that the current environment can reach the API successfully.

Source: SKILL.md on GitHub

Third-party checks

1 warning15d4 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill enables an AI agent to interact with the Runway API to manage media generations and account resources. It demonstrates a strong security posture by guiding the user to manage API secrets via environment variables rather than sharing them in the conversation. All external requests and resources are associated with official Runway vendor domains.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: MEDIUM · 1 issue

  • ZeroLeaks5mo

    2 findings · Score: 80/100

Provenance

Signed by skilld at 82d9fad. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated last month

Capability

What it can do
Reads files Runs commands
user-invocable
true
All 2 allowed tools
ReadBash(node */scripts/runway-api.mjs *)

Topics

  • API
  • runway
  • avatars
  • video-generation
  • image-generation
  • audio-generation
  • documents
  • nodejs

README badge

README badge for runwayml/skills/use-runway-api

What it does

Call the Runway API directly to manage avatars, documents, voices, and trigger media generations from the agent. Includes a bundled Node.js runtime script that handles authentication and provides fast-path commands for listing resources and waiting on generation tasks.

Generated from the current SKILL.md.

Frequently asked

Does this skill require API credentials?
Yes. You must set `RUNWAY_SKILLS_API_SECRET` environment variable before your first call. Run `node <skill-dir>/scripts/runway-api.mjs auth status` to verify credentials are configured.
Can I use this skill to write Runway integration code into my project?
No. This skill is for direct account actions (creating avatars, triggering generations, checking balance). For writing integration code, use the `+integrate-*` skills instead (`+integrate-video`, `+integrate-image`, `+integrate-audio`, `+integrate-characters`, `+integrate-documents`).
What do I do if a generation takes a long time?
Run `node <skill-dir>/scripts/runway-api.mjs wait <task-id>` to poll the status. The skill automatically runs `wait` after generation calls, so you should not need to do this manually.
How long are the generated media URLs valid?
The signed URLs expire in 24–48 hours. If you want to keep the output, download it locally during that window.
Can I use this skill with staging endpoints?
Yes. Add `--stage` to any command and set `RUNWAY_SKILLS_API_SECRET_STAGE` environment variable to target the staging API instead of production.

Generated from the current SKILL.md. These answers refresh after source changes.