Genesis Docs

Genesis ships a bundled runway provider for hosted video generation.

Property Value
Provider id runway
Auth RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY
API Runway task-based video generation (GET /v1/tasks/{id} polling)

Getting started

Set the API key

```bash
genesis onboard --auth-choice runway-api-key
```

Set Runway as the default video provider

```bash
genesis config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
```

Generate a video

Ask the agent to generate a video. Runway will be used automatically.

Supported modes

Mode Model Reference input
Text-to-video gen4.5 (default) None
Image-to-video gen4.5 1 local or remote image
Video-to-video gen4_aleph 1 local or remote video
Local image and video references are supported via data URIs. Text-only runs currently expose `16:9` and `9:16` aspect ratios.
Video-to-video currently requires `runway/gen4_aleph` specifically.

Configuration

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "runway/gen4.5",
      },
    },
  },
}

Advanced configuration

Environment variable aliases

Genesis recognizes both `RUNWAYML_API_SECRET` (canonical) and `RUNWAY_API_KEY`.
Either variable will authenticate the Runway provider.

Task polling

Runway uses a task-based API. After submitting a generation request, Genesis
polls `GET /v1/tasks/{id}` until the video is ready. No additional
configuration is needed for the polling behavior.

Related