# Runway Automation (`igolaizola/runway-automation`) Actor Automate Runway to generate AI videos via API or UI. Create multiple videos simultaneously, manage batch processing, and view results in a built-in video gallery for easy browsing and downloading. Perfect for streamlining your RunwayML workflow. - **URL**: https://apify.com/igolaizola/runway-automation.md - **Developed by:** [IΓ±igo Garcia Olaizola](https://apify.com/igolaizola) (community) - **Categories:** AI, Automation, Videos - **Stats:** 119 total users, 0 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 1.00 out of 5 stars ## Pricing from $19.00 / monthly usage access This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Runway Automation ### 🎬 What does Runway Automation do? Runway Automation enables you to automate AI video generation on [RunwayML](https://www.runwayml.com) without manual intervention. With this actor, you can: - πŸ€– Process multiple video prompts in bulk - πŸŽ₯ Generate videos either from text prompts (text-to-video) or from images (image-to-video) - ⚑ Handle multiple jobs concurrently - ⏳ Manage random wait times between operations - πŸ“ Generate an album HTML file for easy video browsing and downloading #### Video Generation Modes - **Image-to-Video:**\ If you supply image URLs (via the `images` parameter) or a Google Drive folder URL (via the `googleDriveFolder` parameter), videos will be generated using your images. If you also provide text prompts, they will be used as additional input. When there are fewer prompts than images, the prompts will be repeated (looped) to ensure every image is paired with a prompt. - **Text-to-Video:**\ If no images or Google Drive folder is provided, the generation will be based solely on the text prompts you supply. **Note:** When using the `gen3-alpha-turbo`, `gen4` or `gen4-turbo` models, direct text-to-video conversion is not supported. In these cases, if no image is provided, your prompt will first be used to generate an image using "RunwayML Frames", and then that image will be converted into a video. You can specify different prompts for the image generation and the video conversion by separating them with a vertical bar (`|`). For example:\ `"A bomb with a time countdown | The bomb explodes"`\ will use `"A bomb with a time countdown"` to generate the image, and `"The bomb explodes"` as the video prompt. ### πŸ”‘ Prerequisites Before using this actor, you need: 1. An active Runway subscription 2. Your Runway session token for authentication 3. The [LocalStorage Exporter Chrome extension](https://chromewebstore.google.com/detail/localstorage-exporter/gnfhbfoioepibbdcbikgcmenpdfgohmd) ### πŸš€ Setup Guide #### Getting Your Runway Session Token 1. Install the LocalStorage Exporter Chrome extension. 2. Log in to [app.runwayml.com](https://app.runwayml.com). 3. Click on the LocalStorage Exporter extension icon. 4. Click **Export to Clipboard**. 5. Copy the exported session data and paste it into the actor's `session` field. #### Running the Actor 1. Paste your session token into the actor's `session` input field. 2. Enter your desired video prompts or specify image URLs (or a Google Drive folder URL) for image-to-video conversion. 3. Configure generation options (choose mode, model, aspect ratio, video duration, etc.). 4. Select a proxy from your country (recommended). 5. Run the actor. ### βš™οΈ Input Parameters | Parameter | Type | Description | Default | | -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | `session` | String | Your Runway session token from [app.runwayml.com](https://app.runwayml.com) (required) | - | | `folder` | String | Runway folder where videos will be generated. **Note:** This folder must be manually created in Runway. | Generations | | `prompts` | Array | List of text prompts to generate videos. | - | | `images` | Array | *(Optional)* List of image URLs for image-to-video conversion. You can also use a Google Drive folder URL instead. | - | | `googleDriveFolder` | String | *(Optional)* Google Drive folder URL containing images for video generation. The folder must be publicly shared. | - | | `mode` | Select | Generation mode: "explore" (slow, doesn't consume credits) or "credits" (fast, consumes credits) | explore | | `model` | Select | Model to generate videos. Options:
β€’ `gen3-alpha` – Text-to-video only
β€’ `gen3-alpha-turbo` – Supports vertical videos
β€’ `gen4` and `gen4-turbo` – New models with expanded aspect ratios (e.g., 1:1, 4:3, 3:4, 21:9) | gen4-turbo | | `aspectRatio` | Select | Aspect ratio of the generated video. Options:
β€’ "16:9"
β€’ "9:16" (only `gen4` or `gen3-alpha-turbo`)
β€’ "1:1" (only `gen4` or `gen4-turbo`)
β€’ "4:3" (only `gen4` or `gen4-turbo`)
β€’ "3:4" (only `gen4` or `gen4-turbo`)
β€’ "21:9" (only `gen4` or `gen4-turbo`) | 16:9 | | `seconds` | Select | Duration of the generated video. Options: "5s" or "10s" | 10s | | `concurrency` | Integer | Number of concurrent jobs. | 1 | | `minWait` | Integer | Minimum wait time between operations (seconds). A random wait time is chosen between the minimum and maximum values. | 5 | | `maxWait` | Integer | Maximum wait time between operations (seconds). | 10 | | `jobTimeout` | Integer | Maximum time to wait for job completion (seconds). If a job takes longer than this timeout, it will be skipped. | 300 | | `proxyConfiguration` | Object | Configuration for selecting proxies to use. | Uses Apify Residential proxy by default | ### πŸ“‹ Output Format The actor provides results in a structured JSON format. An example output looks like this: ```json [ { "album_url": "https://api.apify.com/v2/key-value-stores/1Ht4z6r0m1OfBqZs1/records/album.html#619775b2-1f53-409e-ad1d-5a8336b138b8", "prompt": "Modern residential houses in nature, minimalist and elegant architecture, large glass facades, surrounded by trees, mountains, or lakes with sunlight streaming through", "url": "https://cdn.runwayml.com/619775b2-1f53-409e-ad1d-5a8336b138b8/video.mp4", "preview_url": "https://cdn.runwayml.com/619775b2-1f53-409e-ad1d-5a8336b138b8/preview.jpg", "job_id": "619775b2-1f53-409e-ad1d-5a8336b138b8", "image_url": "https://drive.usercontent.google.com/download?id=14ur340HEc31z4z1Y0C1_" } ] ``` ### πŸŽ₯ Accessing Generated Videos The actor saves an `album.html` file to the KeyValue store, providing an interface for easy browsing and downloading of your generated videos. You can access it by: - Clicking any "Album URL" field in the results table. - Navigating to **Run > Storage > KeyValueStore** and locating the `album.html` file. The album interface offers several features: - **Filtering:** Search videos by prompt text or other metadata. - **Batch Operations:** Select multiple videos for batch downloads. - **Detailed Viewing:** Open videos in new tabs for closer inspection. - **Download Options:** Download selected videos as a ZIP file. Here's an example album showcasing some generated videos so you can see how your results will be displayed: [Browse Example Gallery](https://igolaizola.github.io/runway-automation/) ### ⚠️ Usage Guidelines and Best Practices #### Account Safety - Automating Runway accounts may lead to termination. - Use this actor only for batch jobs you would normally perform manually. - Avoid running the automation continuously (24/7). - Always follow Runway's terms of service. #### Performance Optimization - Start with 1–2 concurrent jobs and adjust based on performance. - Use proxies from your region to improve reliability. - Set appropriate job timeouts based on your selected generation mode. - Regularly update your session token if you plan long sessions. #### General Tips - Test your setup with a small batch of prompts before scaling up. - Use clear, descriptive prompts to keep your results organized. - Monitor job success rates and tweak settings as needed. - Note that failed jobs are logged but won’t stop the entire process. ### πŸ’³ How much will it cost to use Runway Automation? Apify provides you with $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). You can try and test Runway Automation for free with these credits. If you plan to use it regularly, consider subscribing to one of Apify’s plans. We recommend the [$49/month Personal plan](https://apify.com/pricing) which covers the costs of Runway Automation along with numerous executions. # Actor input Schema ## `session` (type: `string`): Session from app.runway.com ## `folder` (type: `string`): Runway folder where assets will be generated, it must be manually created in Runway ## `prompts` (type: `array`): List of prompts to generate videos ## `images` (type: `array`): List of image URLs to generate videos. (You can also use Google Drive folder URL instead) ## `googleDriveFolder` (type: `string`): Google Drive folder URL with images to generate videos. It must be publicly shared. ## `mode` (type: `string`): Mode to generate videos ## `model` (type: `string`): Model to generate images (text to video only available for 'Gen 3 Alpha') ## `aspectRatio` (type: `string`): Aspect ratio of the generated images ## `seconds` (type: `string`): Seconds of the generated video ## `concurrency` (type: `integer`): Number of concurrent jobs ## `minWait` (type: `integer`): Minimum wait time in seconds. Wait time will be randomly selected between minimum and maximum wait time. ## `maxWait` (type: `integer`): Maximum wait time in seconds. Wait time will be randomly selected between minimum and maximum wait time. ## `jobTimeout` (type: `integer`): Job timeout in seconds. If the job takes longer than the timeout, it will be skipped. ## `proxyConfiguration` (type: `object`): Select proxies to be used. ## Actor input object example ```json { "session": "insert-your-session-here", "folder": "Generations", "mode": "explore", "model": "gen4-turbo", "aspectRatio": "16:9", "seconds": "10s", "concurrency": 1, "minWait": 5, "maxWait": 10, "jobTimeout": 300, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "session": "insert-your-session-here", "folder": "Generations", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("igolaizola/runway-automation").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "session": "insert-your-session-here", "folder": "Generations", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("igolaizola/runway-automation").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "session": "insert-your-session-here", "folder": "Generations", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call igolaizola/runway-automation --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,igolaizola/runway-automation" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/n1m35KU2wNXGuYPNn/builds/otLrekzMpyhzAc0bF/openapi.json