How to Get a Runway ML API Key
Create a Runway account at the Runway Developer Portal, generate your API key, store it securely, then integrate with Bifrost for virtual keys, budgets, and cost governance. Complete setup in minutes.
Runway provider summary
Bifrost can proxy Runway generative media APIs for centralized keys, budgets, and audit trails.
| Property | Details |
|---|---|
| Description | Runway provides generative video, image, and audio APIs for creative and production workflows. |
| Provider route on Bifrost | runway/<model> |
| Provider doc | Runway |
| API endpoint for provider | https://api.runwayml.com/v1 |
| Supported endpoints | /v1/videos |
Official Runway Resources
Official Runway developer documentation and console links.
Prerequisites
Before you begin, you will need:
[ QUICK START ]
How Do You Get a Runway API Key in 5 Steps?
Create a Runway account
Use the Runway Developer Portal.
Go to the Runway Developer Portal and sign up or log in.
Open API settings
In your account settings, find the API or Developers section where keys are managed.
Generate and copy your API key
Copy the key immediately, it may not be shown again.
Create a new API key, name it for your environment, and copy the value into a secure store.
export RUNWAY_API_KEY="..."
Add credits for API access
Runway bills API usage with credits.
When you are ready for production, purchase credits or upgrade your plan in the Runway developer dashboard billing settings.
Make your first API request
Authenticate with Bearer tokens.
Runway uses Authorization: Bearer on REST endpoints:
$ curl https://api.runwayml.com/v1/text_to_image \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $RUNWAY_API_KEY" \ -d '{ "model": "gen4_image", "promptText": "A cinematic mountain landscape at sunset" }'
[ MODELS ]
Available Runway Models
| Model | API ID | Best for |
|---|---|---|
| Gen-4 Turbo | gen4_turbo | Fast generative video from images or text. |
| Gen-4 Image | gen4_image | High-quality still image generation. |
| Gen-3 Alpha Turbo | gen3a_turbo | Earlier video generation for compatibility. |
| Gen-3 Alpha | gen3a | Gen-3 video without turbo optimizations. |
| Upscale v1 | upscale_v1 | Video upscaling. |
Models and availability change over time. See the Runway's API documentation for the latest list and pricing.
[ TROUBLESHOOTING ]
Troubleshooting Common Runway Issues
| Error | Likely Cause | What to Do |
|---|---|---|
401 Unauthorized | Invalid or missing API key. | Verify your API key is correct. Generate a new key if needed. |
400 Bad Request | Invalid request format or unsupported model. | Check request format and confirm model ID is valid. |
429 Rate Limited | Rate limit exceeded for your plan. | Upgrade your plan or implement exponential backoff. Use Bifrost for intelligent load distribution. |
502/503 Service Error | Temporary Mistral service unavailability. | Retry after a delay. Check Mistral status page. Configure failover with Bifrost. |
[ PRODUCTION-READY ]
Use Runway with Bifrost
Bifrost is a drop-in replacement for Runway SDKs: keep your client code and change the base URL to your gateway. Bifrost handles cost tracking, virtual keys, budgets, and failover automatically.
Step 1: Start Bifrost and register Runway
Run the Bifrost gateway and configure your Mistral credentials in the Web UI.
$ npx -y @maximhq/bifrost
✓ Bifrost started ├─ HTTP server listening on http://localhost:8080 ├─ Web UI available at http://localhost:8080 └─ Configure providers and virtual keys in the dashboard
Step 2: Point your OpenAI SDK at Bifrost
Update your OpenAI SDK client to route through the Bifrost gateway.
import openai from OpenAI client = openai.OpenAI( api_key="sk-bf-your-virtual-key", base_url="http://localhost:8080/openai" ) response = client.chat.completions.create( model="gen4_image", messages=[{"role": "user", "content": "Hello from Bifrost!"}] ) print(response.choices[0].message.content)
x-bf-vk or Authorization: Bearer sk-bf-* per the Bifrost documentation.[ WHAT'S NEXT ]
Explore Bifrost Resources
You have your API key. Add governance, guardrails, and MCP controls for production.
[ BIFROST FEATURES ]
Open Source & Enterprise
Everything you need to run AI in production, from free open source to enterprise-grade features.
01 Governance
SAML support for SSO and Role-based access control and policy enforcement for team collaboration.
02 Adaptive Load Balancing
Automatically optimizes traffic distribution across provider keys and models based on real-time performance metrics.
03 Cluster Mode
High availability deployment with automatic failover and load balancing. Peer-to-peer clustering where every instance is equal.
04 Alerts
Real-time notifications for budget limits, failures, and performance issues on Email, Slack, PagerDuty, Teams, Webhook and more.
05 Log Exports
Export and analyze request logs, traces, and telemetry data from Bifrost with enterprise-grade data export capabilities for compliance, monitoring, and analytics.
06 Audit Logs
Comprehensive logging and audit trails for compliance and debugging.
07 Vault Support
Secure API key management with HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, and Azure Key Vault integration.
08 VPC Deployment
Deploy Bifrost within your private cloud infrastructure with VPC isolation, custom networking, and enhanced security controls.
09 Guardrails
Automatically detect and block unsafe model outputs with real-time policy enforcement and content moderation across all agents.
[ SHIP RELIABLE AI ]
Try Bifrost Enterprise with a 14-day Free Trial
Drop-in replacement for any AI SDK
Change just one line of code. Works with OpenAI, Anthropic, Vercel AI SDK, LangChain, and more.
[ FAQ ]
Frequently Asked Questions
Runway APIs cover generative video, images, and related media tasks via REST endpoints and async tasks.
New accounts may receive trial credits. Production API usage typically requires a paid plan or purchased credits.
Send your API key as a Bearer token in the Authorization header on https://api.runwayml.com.
Many Runway operations are task-based, you create a task and poll for completion. See the Runway API docs for each endpoint.
Configure Runway in the Bifrost dashboard and route requests through your local gateway for governance.
Implement retries with backoff and monitor usage in Runway. Use Bifrost budgets to cap spend per team.