> ## Documentation Index
> Fetch the complete documentation index at: https://docs.varios-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Runway

> Generates MP4 videos via Runway API using image-to-video when a chat image exists, otherwise text-to-video.

## Options

<ParamField body="model" type="string" required>
  Runway model name (see Runway API documentation).
</ParamField>

<ParamField body="runwayApiKey" type="string" required>
  API key. Store as a hidden option.
</ParamField>

<ParamField body="runwayApiVersion" type="string">
  `X-Runway-Version` header, default `2024-11-06`.
</ParamField>

<ParamField body="endpointUrl" type="string">
  Optional base URL; default `https://api.dev.runwayml.com/v1/`.
</ParamField>

<ParamField body="costs" type="number">
  Optional flat cost per successful run.
</ParamField>

## Arguments

<ParamField body="prompt" type="string" required>
  Motion or camera instruction for video generation.
</ParamField>

<ParamField body="ratio" type="string">
  `1280:720`, `720:1280`, `768:1280`, `1280:768`; default `1280:720`.
</ParamField>

<ParamField body="duration" type="integer">
  Duration in seconds (1-10), default 5.
</ParamField>

<ParamField body="lastImagesCount" type="integer">
  Which of the latest chat images to use (default 1, max. 3). If no image is available, connector falls back to text-to-video.
</ParamField>

## Prompt function

```
\Avency\BotAPI\Service\Adapter\Runway::execute
```