Keys / Runway

RUNWAYML_API_SECRET

The Runway API key your app generates video, images and audio with. Each key belongs to a project, not a person.

Starts with
key_
Expires
the docs don't say
API
none; Developer Portal only

Get it

Create one on dev.runway.com/settings/api-keys. The steps aren't recorded yet.

Set it

RUNWAYML_API_SECRET=key_...

The Python and Node.js SDKs read it from this variable when you don't pass a key. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. In the Developer Portal, open the project's API Keys tab and create a new key. You need the Admin or Developer role. Copy it; it's shown once.
  2. Deploy it everywhere that reads RUNWAYML_API_SECRET.
  3. Check that requests succeed with the new key, then disable the old one. Removing a user from the project doesn't disable keys they made.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16