POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 const axios = require('axios'); const FormData = require('form-data'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/runway-gen4-aleph"; const reqBody = { "seed": 42, "video": "https://segmind-resources.s3.amazonaws.com/input/c08771b9-b671-4c12-9ea7-af4048b9d194-894a8bdf-6064-40ea-a78d-06c1abff262b.mp4", "prompt": "make it winter", "aspect_ratio": "9:16" }; (async function() { try { const formData = new FormData(); // Append regular fields for (const key in reqBody) { if (reqBody.hasOwnProperty(key)) { formData.append(key, reqBody[key]); } } // Convert and append images as Base64 if necessary const response = await axios.post(url, formData, { headers: { 'x-api-key': api_key, ...formData.getHeaders() } }); console.log(response.data); } catch (error) { console.error('Error:', error.response ? error.response.data : error.message); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


seedint ( default: 42 )

Random seed for reproducibility. Set specific numbers for consistent results across runs.


videostr *

Input video for transformation, max 16MB. Use high-quality clips for best results.


promptstr *

Text prompt to guide video transformation. Try 'in summer' for seasonal changes.


aspect_ratioenum:str ( default: 16:9 )

Choose desired video aspect ratio. Use '21:9' for cinematic effects.

Allowed values:


reference_imagestr ( default: 1 )

Image to influence video style. Select vibrant images for colorful outputs.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Runway Aleph - AI Video Editing Model

Edited by Segmind Team on September 24, 2025.

What is Runway Aleph?

Runway Aleph is a next-gen video model designed to redefine how video editing is done. This AI model is integrated with intelligent automation, making it a multitasking visual manipulation system. It is an ideal tool for creators that empowers them to execute multiple video editing tasks, including adding, removing, or transforming objects through basic text prompts or image references. Runway Aleph reigns over other video editing tools (in which a user has to implement frame-by-frame changes) by understanding the context and performing complex edits throughout the video sequences while ensuring temporal consistency and high visual fidelity.

Key Features of Runway Aleph

  • Object manipulation: It makes it possible to add, remove, or replace objects consistently across frames for seamless edits.
  • Environment transformation: The model can be used to change lighting, weather, seasons, or backgrounds instantly.
  • Style transfer: It can implement artistic styles or cinematic looks using reference images.
  • Camera angle generation: It can create new perspectives and shots from existing footage, transforming the video's visuals.
  • Green screen isolation: It automatically detects and replaces backgrounds.
  • Motion preservation: It upholds natural movements and physics through the edits.
  • Multi-format support: It is compatible with various aspect ratios: square to widescreen 21:9.

Best Use Cases

  • Content creators can use this model to transform seasonal footage, modify video aesthetics, and remove unwanted elements from the video without reshoots, thus saving time and money.
  • Filmmakers can utilize it for rapid prototyping of visual effects before the final production; they can implement environment changes and style experimentation during pre-production.
  • Marketing teams can use their existing video assets and adapt them for different campaigns, seasons, or brand guidelines.
  • Social media managers can redesign and adapt content across different platforms by changing aspect ratios and visual styles to match the aesthetics of the specific platform.
  • Educational content producers can design multiple versions of instructional videos to go with specific visual contexts or environments.

Prompt Tips and Output Quality

  • Provide specific, descriptive prompts for best results. For example, instead of the prompt, "change background," use "replace with sunny beach scene with palm trees." Providing the reference of seasonal changes works particularly well; try "make it winter with snow" or "transform to autumn with orange leaves."

  • Use the reference image parameter to guide style and color palette. High-contrast, vibrant reference images will produce more dramatic transformations.

  • Set consistent seed values when iterating on the same concept to maintain visual coherence across multiple generations.

FAQs

How large can my input video be?
For a video, the maximum file size can be 16MB. Use high-quality video prompts for optimal results, but compress larger files before uploading.

What aspect ratio does Aleph support?
You can choose from 16:9, 9:16, 4:3, 3:4, 1:1, and cinematic 21:9 ratios to match your requirements based on a specific platform.

Can I use reference images with text prompts?
Yes, if you combine reference images with text prompts, you will get better control. The reference image influences style while the text prompt guides specific transformations.

How do I get consistent results?
Use the seed parameter with specific numbers. The same seed with identical inputs produces reproducible outputs.

Is Runway Aleph better than other video AI models?
While other video AI models are usually incapable of performing multi-task video editing, Runway Aleph can seamlessly perform multi-level editing with strong temporal consistency.

What video formats work best?
For high visual fidelity, the MP4 format with good lighting and stable footage is the best option for optimal results.