Runway

Introduction

Runway's AI models are integrated into the Runware platform through our unified API, providing access to cinematic video generation technology built for professional storytelling and creative iteration.

Through the providerSettings.runway object, you can access Runway's content moderation controls while maintaining the consistency of Runware's standard API structure. This page documents the technical specifications, parameter requirements, and provider-specific settings for all Runway models available through our platform.

Video models

providerSettings » runway runway object

Configuration object for Runway-specific settings and controls.

View example

"providerSettings": {
  "runway": { 
    "contentModeration": { 
      "publicFigureThreshold": "low"
    } 
  } 
}

Properties ⁨1⁩ property

providerSettings » runway » contentModeration contentModeration object

Configuration object for content moderation settings. Controls how strictly the model filters potentially sensitive content, particularly regarding recognizable public figures.

Object properties:

publicFigureThreshold (string, optional, default: "auto"): Controls how strictly the model prevents generation of recognizable public figures in the output video.

Available values for publicFigureThreshold:

auto: Automatically determines the appropriate threshold based on content.
low: Less strict filtering, may allow more recognizable public figures.

View example

"providerSettings": {
  "runway": {
    "contentModeration": {
      "publicFigureThreshold": "low"
    }
  }
}

Runway Gen-4 Turbo

Runway’s Gen-4 Turbo is a high-speed image-to-video model built for instant creative experimentation. It produces dynamic, cinematic motion with exceptional fluidity and detail, transforming a single image into a fully realized video in seconds.

Model AIR ID: runway:1@1.

Supported workflows: Image-to-video.

Technical specifications:

Positive prompt: 1-1000 characters (optional).
Supported dimensions: 1280×720 (16:9), 720×1280 (9:16), 1104×832, 832×1104, 960×960 (1:1), 1584×672 (21:9).
Duration: 2-10 seconds (default: 10).
Frame images: Supports first frame for inputs.frameImages (required).
Input image requirements: 20MB file size limit.

Provider-specific settings:

Parameters supported: contentModeration.publicFigureThreshold.

Image-to-video

{
  "taskType": "videoInference",
  "taskUUID": "6ba7b829-9dad-11d1-80b4-00c04fd430c8",
  "model": "runway:1@1",
  "inputs": {
    "frameImages": [
      {
        "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
        "frame": "first"
      }
    ],
    "positivePrompt": "The scene comes to life with dynamic movement",
    "duration": 10,
    "width": 1280,
    "height": 720
  }
}

With less strict content moderation

{
  "taskType": "videoInference",
  "taskUUID": "550e8400-e29b-41d4-a716-446655440010",
  "model": "runway:1@1",
  "positivePrompt": "A portrait shot with natural lighting",
  "duration": 5,
  "width": 960,
  "height": 960,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "low"
      }
    }
  }
}

Runway Aleph

Runway's flagship video-to-video model is built for realism and expressive storytelling. It transforms videos with cinematic precision and supports one reference image to guide visual style or content direction.

Model AIR ID: runway:2@1.

Supported workflows: Video-to-video.

Technical specifications:

Positive prompt: 1-1000 characters (required).
Input video: Supports inputs.video (required).
Reference images: Supports inputs.referenceImages with 1 image (optional).
Supported dimensions: 1280×720 (16:9), 720×1280 (9:16), 1104×832, 832×1104, 960×960 (1:1), 1584×672 (21:9), 848×480, 640×480.
Input video requirements: 20MB file size limit.
Input image requirements: 20MB file size limit.

Provider-specific settings:

Parameters supported: contentModeration.publicFigureThreshold.

Video-to-video

{
  "taskType": "videoInference",
  "taskUUID": "550e8400-e29b-41d4-a716-446655440011",
  "model": "runway:2@1",
  "inputs": {
    "video": "d7e8f9a0-2b5c-4e7f-a1d3-9c8b7a6e5d4f"
  },
  "positivePrompt": "Enhance this video with cinematic color grading and smooth motion",
  "width": 1920,
  "height": 1080
}

Video-to-video with reference

{
  "taskType": "videoInference",
  "taskUUID": "6ba7b830-9dad-11d1-80b4-00c04fd430c8",
  "model": "runway:2@1",
  "inputs": {
    "video": "d7e8f9a0-2b5c-4e7f-a1d3-9c8b7a6e5d4f"
    "referenceImages": ["c64351d5-4c59-42f7-95e1-eace013eddab"]
  },
  "positivePrompt": "Transform this scene with dynamic camera movement and atmospheric lighting",
  "width": 1280,
  "height": 720
}