# Runway integration

> Runway developer API for generative video, image, and audio models, real-time avatar characters, recipes, and model routing.

- Authentication: apiKey

## Tools (65)

- **Cancel or delete a task**: Cancel a running, pending or throttled task, or delete a finished one.
- **Cancel realtime session**: Cancel an active realtime session.
- **Control a character**: This endpoint will start a new task to control a character's facial expressions and body movements using a reference video.
- **Create a marketing stock image**: Generate a polished marketing stock image from a text brief and optional brand logo image.
- **Create a product ad video**: Generate a cinematic product ad from product images, optional style references, product info, and creative direction.
- **Create a product UGC video**: Generate a vertical user-generated content ad from a character image, product image, product details, and optional creative direction.
- **Create avatar**: Create a new avatar with a reference image and voice.
- **Create a voice**: Create a custom voice from a text description, or clone a voice from an audio sample.
- **Create document**: Create a new knowledge document. Documents can be attached to avatars to provide additional context during conversations.
- **Create Model Router**: Create a Model Router configuration.
- **Create product campaign images**: Generate four fashion campaign images from a product image and style brief.
- **Create realtime session**: Create a new realtime session with the specified model configuration. The returned ID is also the conversation ID used later to fetch transcripts and recordings from the avatar conversation endpoints.
- **Delete avatar**: Delete an avatar.
- **Delete a voice**: Delete a custom voice.
- **Delete conversation**: Delete a conversation and its associated data.
- **Delete document**: Delete a knowledge document. This also removes it from all avatars it was attached to.
- **Delete Model Router**: Delete a Model Router configuration. Deleted Model Routers cannot be used for generation.
- **Generate avatar video from audio or text**: Start an asynchronous task to generate a video of an avatar speaking. Provide `speech` with `type: "audio"` (audio file) or `type: "text"` (text script for TTS).
- **Get a linked workspace audit log entry**: Get a single audit log entry, including its metadata and forensic details, for a linked Runway workspace you administer.
- **Get avatar**: Get details of a specific avatar.
- **Get avatar usage**: Get aggregate usage statistics for avatar conversations, including total duration, session counts, average duration, and a per-day breakdown.
- **Get a voice**: Get details about a specific custom voice.
- **Get conversation**: Get detailed information about a specific conversation, including the transcript and recording download URL when available.
- **Get document**: Get details of a specific knowledge document.
- **Get organization information**: Get usage tier and credit balance information about the organization associated with the API key used to make the request.
- **Get realtime session**: Get the status of a realtime session. This endpoint uses the same ID that the avatar conversation endpoints later expose as the conversation ID.
- **Get task detail**: Return the status, output URLs and cost of a generation task.
- **Get workflow details**: Returns details about a specific published workflow, including its graph schema.
- **Get workflow invocation detail**: Return details about a workflow invocation. Consumers of this API should not expect updates more frequent than once every five seconds for a given workflow invocation.
- **Image to Video**: This endpoint will start a new task to generate a video from an image
- **Image upscale**: Upscale an image with Magnific precision upscaling. Each input dimension must be between 300px and 8000px.
- **List avatars**: List avatars for the authenticated user with cursor-based pagination.
- **List conversations**: List realtime avatar conversations for the authenticated user with cursor-based pagination.
- **List documents**: List knowledge documents for the authenticated user with cursor-based pagination.
- **List linked workspace audit logs**: List audit log entries for the linked Runway workspaces you administer, newest first. Authorized via the account link between this API project and the workspace.
- **List linked workspace usage**: List per-generation credit-usage rows for the linked Runway workspaces you administer, newest first.
- **List Model Router requests**: Paginated routing history for live Model Router requests (successful routes and failures).
- **List Model Routers**: List Model Router configurations for the authenticated organization with cursor-based pagination.
- **List published workflows**: Returns a list of all published workflows for the authenticated user, grouped by source workflow with their published versions.
- **List voices**: List custom voices for the authenticated organization with cursor-based pagination.
- **Localize an ad image**: Localize an existing ad image for a target language, preserving visual creative while adapting on-screen messaging.
- **Multi-Shot Video**: Generate a multi-cut video from a story prompt (auto mode) or a custom shot list (custom mode)
- **Preview a voice**: Generate a short audio preview of a voice from a text description. Use this to audition a voice before creating it.
- **Query credit usage**: Fetch credit usage data broken down by model and day for the organization associated with the API key used to make the request.
- **Retrieve Model Router**: Retrieve a Model Router configuration by ID.
- **Routed audio generation**: Start an audio generation task using a saved Model Router config instead of naming a model.
- **Routed image generation**: Start an image generation task using a saved Model Router config instead of naming a model.
- **Routed video generation**: Start a video generation task using a saved Model Router config instead of naming a model.
- **Run a published workflow**: Start a new task to execute a published workflow. You can optionally provide custom input values via `nodeOutputs` to override the defaults defined in the workflow graph.
- **Sound Effect**: This endpoint will start a new task to generate sound effects from a text description
- **Speech to speech**: This endpoint will start a new task to convert speech from one voice to another in audio or video.
- **Swap a product in a reference video**: Replace the product in a reference video with a new product, preserving camera motion, lighting, and scene composition.
- **Text to Image**: This endpoint will start a new task to generate images from text and/or image(s)
- **Text to Speech**: This endpoint will start a new task to generate speech from text
- **Text to Video**: This endpoint will start a new task to generate a video from a text prompt
- **Update avatar**: Update an existing avatar. At least one field must be provided.
- **Update a voice**: Update the name and/or description of a custom voice.
- **Update document**: Update a knowledge document. At least one of `name` or `content` must be provided.
- **Update Model Router**: Update a Model Router configuration. Settings changes append a new version; name and description updates do not.
- **Upload a file**: Uploads a temporary media file that can be referenced in API generation requests. The uploaded files will be automatically expired and deleted after a period of time.
- **Video to HDR**: This endpoint starts a task to upconvert an SDR video to true HDR with Ruby, Runway's HDR grading model.
- **Video to Video**: This endpoint will start a new task to generate a video from a video
- **Video Upscale**: This endpoint starts a task to upscale a video
- **Voice dubbing**: This endpoint will start a new task to dub audio content to a target language.
- **Voice isolation**: This endpoint will start a new task to isolate the voice from the background audio. Audio duration must be greater than 4.6 seconds and less than 3600 seconds.

Connect Runway in General Input: https://www.generalinput.com/apps/runway