Connect Runway to your AI agent
Runway provides generative AI APIs for creating and transforming video, images, audio, avatars, voices, and media workflows.
We set up the connection using your own Runway account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
What your agent can do in Runway
Each one is a real action the agent can take on its own, the same things a person clicking around Runway could do. Read-only by default; write actions are confirmed against your policy.
- Cancel Task Cancel a running Runway task or delete its task record. Returns success only when Runway confirms the operation; an already absent task remains a 404 error.
- Create Document Create a Runway knowledge document from markdown or plain text for reuse by avatar workflows.
- Create Ephemeral Upload Create only a temporary Runway media upload slot and return its presigned multipart form details and runway:// URI. This action does not upload file bytes; POST them separately to upload_url using fields before using ru…
- Delete Document Permanently delete a Runway knowledge document by its ID.
- Generate Image Start a Runway text-to-image or reference-guided image generation task and return its task ID and estimated credit cost.
- Generate Sound Effect Generate an audio effect from a text prompt and return the task ID and estimated credit cost.
- Generate Speech Synthesize speech with Runway using an exact model-specific voice and option contract, then return the task ID and estimated credit cost.
- Generate Video from Image Animate one or more input images with a selected Runway model and return the task ID and estimated credit cost.
- Generate Video from Text Start a Runway text-to-video task with a model-specific typed request and return its task ID and estimated credit cost.
- Get Document Get one Runway knowledge document, including its full content and the avatars that currently use it.
- Get Organization Return the connected Runway organization's credit balance, monthly credit spend cap, exact per-model quotas, and current daily generation usage.
- Get Task Get the current status, cost, output URLs, and failure details for a Runway generation task. Runway does not update a task more often than every five seconds.
- Get Usage Return daily Runway credit usage by model for an optional UTC date range of up to 90 days.
- Get Workflow Get a published Runway workflow version and its graph so node IDs and output keys can be inspected before running the workflow.
- Get Workflow Invocation Get the current status, completed node output URLs, and node or invocation failure details for a Runway workflow invocation.
- List Documents List Runway knowledge documents one page at a time, with sorting and an opaque continuation cursor. List results omit full document content.
- List Workflows List the connected account's published Runway workflows and their available versions, ordered as returned by Runway.
- Run Workflow Invoke a published Runway workflow, optionally overriding graph node outputs, and return the created workflow invocation ID.
- Transform Video Transform or restyle an existing video with Runway and return the created task ID and estimated credit cost.
- Update Document Change the name, content, or both for an existing Runway knowledge document. Provide at least one of name or content.
- Upscale Image Start a Runway image upscaling task and return its task ID and estimated credit cost.
- Upscale Video Start a Runway video upscaling task and return its task ID and estimated credit cost.
How we connect it
- 1
Connect your account
You create a key in Runway, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Runway questions, answered.
Ready to put Runway to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Runway.