Edit a video with Aleph
runway_edit_video_alephTransform an existing video with Runway Gen-4 Aleph (video-to-video): a video asset plus a text prompt describing the change or style, optionally guided by an image asset. Use it to restyle or alter footage you have; to make a new video use runway_create_video, to edit with Kling O3 or Seedance 2.5 use runway_create_video (videoAssetId, video_mode). Waits up to ~50 s, then returns the video url and assetId, the failure reason or the taskId for runway_get_task. Uses credits, or none with exploreMode. POST /gen4/video.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video_assetId": "<video_assetId>",
"text_prompt": "<text_prompt>"
},
"name": "runway_edit_video_aleph"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for reproducible results, 1-4294967294; random when omitted. | |
| wait | No | Wait up to ~50 s for the task to finish (default true); false returns the taskId at once. | |
| replyRef | No | Your own reference id, stored and returned with the task. | |
| replyUrl | No | A callback URL the API calls with the task (the runway_get_task shape) when it completes or fails. Default: the replyUrl of your useapi.net account. | |
| exploreMode | No | Explore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan. Omit or false: Credits Mode. | |
| text_prompt | Yes | The transformation or style to apply. | |
| image_assetId | No | image_assetId, an optional image that conditions the result: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset. | |
| video_assetId | Yes | video_assetId, the video to transform (it needs duration, width and height metadata): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset. |