RunwayML Aleph 2

Text-to-Video • RunwayML

runwayml/aleph-2

  • Third-party

RunwayML's video editing model. Edit one frame to update your whole video, make changes across multiple shots, and work with up to 30 seconds of video. Supports keyframe-guided editing for precise control over specific moments in the clip.

Model Info
Terms and License link ↗
More information link ↗
Pricing <ul><li>Default (per second)$0.336</li></ul>

Usage

const response = await env.AI.run(
  'runwayml/aleph-2',
  {
    prompt: 'Transform the scene into a golden-hour sunset with warm lighting',
    video_uri: 'https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/cinematic-scene.mp4',
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "runwayml/aleph-2",
  "input": {
    "prompt": "Transform the scene into a golden-hour sunset with warm lighting",
    "video_uri": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/cinematic-scene.mp4"
  }
}'

{
  "state": "Completed",
  "result": {
    "video": "https://dnznrvs05pmza.cloudfront.net/7449093b-e574-41a5-8308-05e4692fa652.mp4"
  },
  "gatewayMetadata": {
    "keySource": "Unified"
  }
}

Examples

<details>

<summary>Keyframe-Guided Edit — Edit a video using a reference image anchored to the first frame of the output</summary>

const response = await env.AI.run(
  'runwayml/aleph-2',
  {
    prompt: 'Edit the video to match the provided reference frame',
    video_uri: 'https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/nature-close-up.mp4',
    prompt_images: [
      {
        uri: 'https://upload.wikimedia.org/wikipedia/commons/8/85/Tour_Eiffel_Wikimedia_Commons_(cropped).jpg',
        position: 'first',
      },
    ],
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "runwayml/aleph-2",
  "input": {
    "prompt": "Edit the video to match the provided reference frame",
    "video_uri": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/nature-close-up.mp4",
    "prompt_images": [
      {
        "uri": "https://upload.wikimedia.org/wikipedia/commons/8/85/Tour_Eiffel_Wikimedia_Commons_(cropped).jpg",
        "position": "first"
      }
    ]
  }
}'

{
  "state": "Completed",
  "result": {
    "video": "https://dnznrvs05pmza.cloudfront.net/cd7388fe-09d6-4b16-afc5-24bb315eaf14.mp4"
  },
  "gatewayMetadata": {
    "keySource": "Unified"
  }
}

</details>

<details>

<summary>Timed Keyframe Edit — Place a guidance image at a specific timestamp within the input video using keyframes[].seconds</summary>

const response = await env.AI.run(
  'runwayml/aleph-2',
  {
    prompt: 'Change the background to a futuristic cityscape at night',
    video_uri: 'https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/simple-text-to-video.mp4',
    keyframes: [
      {
        uri: 'https://upload.wikimedia.org/wikipedia/commons/8/85/Tour_Eiffel_Wikimedia_Commons_(cropped).jpg',
        seconds: 2.0,
      },
    ],
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "runwayml/aleph-2",
  "input": {
    "prompt": "Change the background to a futuristic cityscape at night",
    "video_uri": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/simple-text-to-video.mp4",
    "keyframes": [
      {
        "uri": "https://upload.wikimedia.org/wikipedia/commons/8/85/Tour_Eiffel_Wikimedia_Commons_(cropped).jpg",
        "seconds": 2.0
      }
    ]
  }
}'

{
  "state": "Completed",
  "result": {
    "video": "https://dnznrvs05pmza.cloudfront.net/a7e054fa-1cf2-4265-a35c-518b8c4d6a1a.mp4"
  },
  "gatewayMetadata": {
    "keySource": "Unified"
  }
}

</details>

<details>

<summary>Content Moderation Override — Edit a video featuring public figures with relaxed content moderation</summary>

const response = await env.AI.run(
  'runwayml/aleph-2',
  {
    prompt: 'Make the background a dramatic stormy sky',
    video_uri: 'https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/cinematic-scene.mp4',
    content_moderation: {
      public_figure_threshold: 'low',
    },
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "runwayml/aleph-2",
  "input": {
    "prompt": "Make the background a dramatic stormy sky",
    "video_uri": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/runwayml__gen-4.5/cinematic-scene.mp4",
    "content_moderation": {
      "public_figure_threshold": "low"
    }
  }
}'

{
  "state": "Completed",
  "result": {
    "video": "https://dnznrvs05pmza.cloudfront.net/ea5b1ccd-3dd6-43c3-86e3-5ed720849e92.mp4"
  },
  "gatewayMetadata": {
    "keySource": "Unified"
  }
}

</details>

Parameters

prompt

stringrequiredminLength: 1maxLength: 1000Text prompt describing the edit to apply to the input video

video_uri

stringrequiredHTTPS URL, Runway URI, or data URI of the source video to edit (≤30 seconds)

▶keyframes[]

arrayminItems: 1maxItems: 5Timed guidance images placed at specific points in the input video. Each entry has a uri and either seconds (absolute timestamp) or at (fractional position). Up to 5.

▶prompt_images[]

arrayminItems: 1maxItems: 5Image keyframes for guiding the edit at specific points in the output video. Up to 5.

seed

integerminimum: 0maximum: 4294967295Random seed for reproducible results

▶content_moderation{}

objectSettings that affect the behavior of the content moderation system

duration

numberexclusiveMinimum: 0Duration of the source video in seconds. Used for billing only — not sent to RunwayML. Provide this so the gateway can compute per-second video cost accurately.

video

stringformat: uriURL to the edited video

API Schemas (Raw)

Input Open Download

Output Open Download

Was this helpful?

YesNo

On this page

RunwayML Aleph 2 - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai/models/runwayml/aleph-2/#page","headline":"RunwayML Aleph 2","description":"RunwayML's video editing model. Edit one frame to update your whole video, make changes across multiple shots, and work with up to 30 seconds of video. Supports keyframe-guided editing for precise control over specific moments in the clip.","url":"https://developers.cloudflare.com/ai/models/runwayml/aleph-2/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: RunwayML's video generation model supporting both text-to-video and image-to-video with customizable duration, aspect ratio, and content moderation controls. title: RunwayML Gen-4.5 image: https://developers.cloudflare.com/og-docs.png

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/llms.txt
Use this file to discover all available pages before exploring further.

RunwayML logo