Generate Video

Overview

You can generate a video using the AI/ML API. In the basic setup, you need only a prompt and the aspect ratio of the desired result.

Ratio

• Type: String

• Key: ratio

• Allowed Values: 16:9, 9:16

Prompt

• Type: String

• Key: prompt

• Character Limit: 512 characters

Image URL

• Type: URL

• Key: image_url

• Description: A HTTPS URL or data URI containing an encoded image to be used as the first frame of the generated

Last Image URL

• Type: URL

• Key: last_image_url

• Description: A HTTPS URL or data URI containing an encoded image to be used as the last frame of the generated

Duration

• Type: Integer

• Key: duration

• Allowed Values: 5, 10

Seed

• Type: Integer

• Key: seed

• Description: If unspecified, a random number is chosen. Varying the seed integer is a way to get different results for the same other request parameters. Using the same seed integer for an identical request will produce similar results

Watermark

• Type: Boolean

• Key: watermark

• Description: A boolean indicating whether or not the output video will contain a Runway watermark

Example

Ensure you replace "my_key" with your actual API key before running the code.

JavaScript

const main = async () => {
  const response = await fetch('https://api.aimlapi.com/v2/generate/video/runway/generation', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer my_key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'gen3a_turbo',
      prompt: 'A jellyfish in the ocean',
      ratio: '16:9',
      image_url: 'https://upload.wikimedia.org/wikipedia/commons/3/35/Maldivesfish2.jpg',
    }),
  }).then((res) => res.json());

  console.log('Generation:', response);
};

main()

Python

import requests


def main():
    url = "https://api.aimlapi.com/v2/generate/video/runway/generation"
    payload = {
        "model": "gen3a_turbo",
        "prompt": "A jellyfish in the ocean",
        "ratio": "16:9",
        "image_url": "https://upload.wikimedia.org/wikipedia/commons/3/35/Maldivesfish2.jpg",
    }
    headers = {"Authorization": "Bearer my_key", "Content-Type": "application/json"}

    response = requests.post(url, json=payload, headers=headers)
    print("Generation:", response.json())

if __name__ == "__main__":
    main()