# Runway ML MCP > Runway ML connects advanced video generation directly into your AI workflow. Generate cinematic clips from simple text prompts, bring still images to life with motion, or blend two keyframes for smooth transitions using models like Gen-3 Turbo and Gen-4 Turbo. It also lets you manage job status, view credits, and cancel costly renders without leaving your chat interface. ## Overview - **Category:** ai-frontier - **Price:** Free - **Tags:** video-generation, generative-ai, media-production, creative-tools, animation, model-inference ## Description Runway ML lets you generate complex video content entirely through conversation. Instead of navigating web interfaces or managing complicated pipelines, you just tell your agent what you want—a 10-second cinematic shot of a futuristic cityscape, for example. Your AI client handles the heavy lifting using best-in-class generative models. If you have an image and want to guide how it moves, you don't need complex keyframe software; you simply describe the motion. This integration puts professional video production tools right into your chat window. With Vinkius in the catalog, Runway ML sits alongside thousands of other specialized connectors, giving your agent access to a complete suite of creative and technical services. You get stunning, highly stylized videos whether you start with pure text prompts or guide animation from a single reference picture. ## Tools ### cancel_task Stops a video generation job that is currently running so you don't waste credits on a failed render. ### gen3_turbo Generates quick, 5-second videos using the Gen-3 Alpha Turbo model for fast testing and prototyping. ### gen4_turbo Creates high-quality video clips using the advanced Gen-4 Turbo model when you need maximum visual fidelity. ### get_organization Retrieves your account's current credit usage and overall organization details for billing tracking. ### get_task Checks the status of a specific job ID, telling you if it succeeded or failed and providing the output link when ready. ### image_text_to_video Creates video by combining a starting image with a text prompt that guides how the camera moves or what happens to the subject. ### image_to_video Animates a still picture into a moving video by specifying a source URL and desired duration. ### interpolate Creates smooth, professional-looking motion clips that transition believably between two separate keyframe images. ### list_tasks Shows a history of your recent video generation jobs so you can see what's been processed recently. ### text_to_video Generates a full video clip simply by providing a detailed text description and specifying the desired length (5 or 10 seconds). ## Prompt Examples **Prompt:** ``` Create a 5 second cinematic video showing a sunset over an alien planet using Runway Gen-3 Turbo. ``` **Response:** ``` Your Runway generation task was successfully submitted to the Gen-3 Turbo model. The task ID is rw_task_1234. You can ask me to poll this task in a moment to review the final video output. ``` **Prompt:** ``` Take this reference image URL and animate it with Gen-3 Turbo to make the camera slowly pan backwards. ``` **Response:** ``` Image to video request initiated using the `image_text_to_video` tool. Your task is now processing and I got the ID 'rw_task_9876'. The animation will be ready shortly. ``` **Prompt:** ``` List all my ongoing tasks on Runway to see if the video has finished rendering. ``` **Response:** ``` I've scanned your recent 10 tasks. I see that task 'rw_task_1234' just SUCCEEDED! Here is the MP4 link to your generated video. ``` ## Capabilities ### Generate video from text You can ask your agent to generate brand new scenes using detailed written prompts and various models. ### Animate still images Bring a static picture into motion by specifying source image URLs, the model, and how long you want the final clip to be. ### Guide motion with text prompts You can generate video that not only starts from an image but also uses a separate text prompt to precisely direct the movement or camera action. ### Smoothly transition between images The system creates fluid, cinematic motion clips by blending two distinct keyframe images together. ### Manage rendering jobs You maintain control of your workflow by listing recent tasks, checking if a render succeeded and retrieving the output link, or canceling expensive jobs to save credits. ## Use Cases ### Developing a new product concept video A marketing team has a mood board but no footage. They ask their agent to generate a 10-second cinematic scene of the product in action using text_to_video, and then use image_text_to_video to guide the camera movement around key features. ### Creating an animated character sequence A content creator wants a specific look for their main character. They run an initial animation using image_to_video on a reference photo, and then use interpolate to smoothly transition the character into a new setting. ### Reviewing project costs A producer finishes a day of testing videos and needs to know how many credits were used. They ask their agent to run get_organization, which immediately reports billing usage so they can plan for tomorrow's renders. ### Troubleshooting failed renders A user submits a complex prompt that fails after 15 minutes of rendering. Instead of waiting, they ask their agent to check the job status with get_task and then use cancel_task to stop it immediately. ## Benefits - Rapid Prototyping: Need to test five different visual concepts? Use text_to_video or gen3_turbo to spin up quick 5-second clips, letting you rapidly iterate on creative direction without leaving your chat window. - Controlled Animation: Instead of guessing how an image will move, use image_text_to_video. You provide the starting photo and then direct its movement with a text prompt, giving you precise control over the animation's trajectory. - High Fidelity Output: For final marketing assets that need to look pristine, use gen4_turbo or text_to_video to leverage the most advanced models available for superior visual quality. - Seamless Blending: When your project requires a smooth shift between two distinct visuals, the interpolate tool handles it. It creates professional-grade transitional motion clips you'd otherwise need specialized software for. - Cost Management: Don't let renders run forever. Use list_tasks to track jobs and cancel_task immediately stops costly rendering pipelines when your creative needs change. ## How It Works The bottom line is that once connected, your AI client treats complex video generation tasks like simple chat commands. 1. First, activate the Runway ML integration in your AI client through Vinkius. 2. Next, sign into the developer portal and provide your secure API token for connection. 3. Finally, tell your agent exactly what you want. For instance: 'Generate a 5-second video of a cyberpunk city using Gen-3 Turbo.' ## Frequently Asked Questions **How do I use Runway ML MCP for text-to-video generation?** Use the text_to_video tool by giving your agent a detailed description of what you want. You specify the prompt and either 5 or 10 seconds, and it returns a task ID immediately. **Can I animate an existing photo using Runway ML MCP?** Yes, use image_to_video by providing the source URL. You specify the model and duration, and the system animates that still picture into a video clip. **What if my render job is taking too long? How do I stop it?** You can use cancel_task with the specific task ID. This immediately stops the rendering process and prevents you from wasting valuable credits on an unnecessary job. **How does Runway ML MCP help me blend two different videos?** Use the interpolate tool. It takes two separate keyframe images and generates a single, smooth transitional motion clip between them for professional continuity. **Where do I check my remaining credits after using Runway ML MCP?** Run get_organization to retrieve your current organization details. This shows you exactly how many credits you've used and what your billing status is.