Runway

Velaclaw 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

velaclaw onboard --auth-choice runway-api-key

Set Runway as the default video provider

velaclaw 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 notes

Environment variable aliases

Velaclaw 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, Velaclaw polls GET /v1/tasks/{id} until the video is ready. No additional configuration is needed for the polling behavior.

Video generation

Shared tool parameters, provider selection, and async behavior.

Configuration reference

Agent default settings including video generation model.

Overview

Concepts and configuration

Providers

Runway

Runway

Getting started

Supported modes

Configuration

Advanced notes

Video generation

Configuration reference

​Runway

​Getting started

​Supported modes

​Configuration

​Advanced notes

​Related

Video generation

Configuration reference

Runway

Getting started

Supported modes

Configuration

Advanced notes

Related