Runway
Move briefs, assets and sign-offs through Runway without chasing between tools.
4 ways to read, 2 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Runway, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Generate video from imageApproval by rule
- Generate image from textApproval by rule
- List avatar conversationsRead
Example flow
- Runway · List avatar conversationsDone
- Runway · Generate video from imageNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Runway.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Runway
- Runway's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Start Runway image-to-video and text-to-image generation tasks (billable), and read task status, outputs, credit balance, tier limits, daily credit usage and realtime avatar conversations.
Runway AI API docs- Source actions
- 4
- Destination actions
- 2
- Data types
- 6
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Avatar conversations1
- List avatar conversationsSourceIncremental
List realtime avatar conversations, newest first, with status, avatar and duration. Optionally only those started after a time or with one custom avatar.
Image to video1
- Generate video from imageDestinationNot retried automaticallyApproval before production
Start an image-to-video task from an image URL and an optional prompt. Billable: charges credits. Poll Get task for the output.
Organization1
- Get organisation credits and limitsSource
Get the organisation's credit balance, tier spending cap and per-model daily limits and usage.
Tasks1
- Get taskSource
Get a generation task's status, progress, output URLs, failure reason and credits charged.
Text to image1
- Generate image from textDestinationNot retried automaticallyApproval before production
Start a text-to-image task from a prompt and optional reference images. Billable: charges credits per image. Poll Get task for the output.
Usage1
- Get credit usageSource
Get credits used per day and model (UTC). Defaults to the last 30 days.
Access and limits
- Authentication
- Runway API secret key (Bearer)
- Plans and access
- Runway Dev (API) accounts with prepaid credits. The API is separate from Runway app subscriptions. Usage tiers set concurrency and maximum daily generations per model and rise automatically with spend. API keys belong to a developer-portal organisation.
- Test environment
- There is no sandbox. Every task consumes real credits; test with low-cost models and short durations.
- Rate limits
- No per-minute request limit; usage tiers cap concurrent generations and maximum daily generations (rolling 24 hours) per model. Tasks above the concurrency limit wait as THROTTLED. HTTP 429 means an integration limit was reached and may be retried for reads; generation is never retried automatically.
- Pagination
- Avatar conversations use limit (max 100) and cursor = nextCursor while hasMore. Get task, organisation and usage return single objects.
- Provider events
- Runway does not document task webhooks for the API; poll Get task. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Generate image-to-video and Generate text-to-image are billable: each started task charges credits (estimatedCost is the maximum). They are never retried automatically and Runway documents no idempotency key, so a timed-out request may still have started a task; check the developer portal before repeating it.
- Generation is asynchronous: the operations return a task ID. Poll Get task; output URLs expire within 24 to 48 hours and the files themselves are not downloaded. Binary upload and download is an engine gap, so images must be HTTPS URLs or runway:// URIs created elsewhere; base64 data URIs are refused.
- Model-specific fields vary. Nexra forwards model, prompt, image, ratio, duration, seed, resolution, audio, negative prompt, reference images, output count and quality only when set; Runway validates the combination per model and returns HTTP 400 for unsupported values.
- Excluded by design: cancelling or deleting tasks, text-to-video, video-to-video, upscaling, audio and speech generation, character performance, recipes, workflows, avatar management, voices, documents, uploads and realtime sessions. Avatar conversations can be listed but not started or deleted.
- Organisation usage is a POST query; Runway defaults the window to the last 30 days.
Developer reference
- Create the Runway AI credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Runway, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/runway and the Connections API.