RunwayML
API actions for the RunwayML integration.
RunwayML
Create images and videos with RunwayML and check on their progress.
Generate image with RunwayML
Create an image from a text prompt using RunwayML. The image is generated in the background; use the returned task ID to check when it's ready.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt_text | string | Yes | Describe the image you want to create (1-1000 characters). |
model | string | No | The model to use: gen4_image_turbo, gen4_image, or gemini_2.5_flash. Defaults to gen4_image_turbo. |
ratio | string | No | The image's width-to-height ratio, such as 1024:1024 (square) or 1920:1080 (widescreen). Defaults to 1024:1024. |
seed | number | No | Optional number between 0 and 4294967295. Use the same seed to get the same image again. |
Response
{
"model": "gen4_image_turbo",
"seed": null,
"task_id": "mock_task_id"
}Generate video with RunwayML
Create a video clip from a text prompt using RunwayML. The video is generated in the background; use the returned task ID to check when it's ready.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt_text | string | Yes | Describe the video you want to create. |
model | string | No | The model to use, such as gen4.5 or veo3.1. Defaults to gen4.5. |
ratio | string | No | The video's width-to-height ratio: 1280:720 (widescreen) or 720:1280 (vertical). Defaults to 1280:720. |
duration | number | No | Duration in seconds (5 or 10). Defaults to 5. |
seed | number | No | Optional number. Use the same seed to get the same video again. |
Response
{
"model": "gen4.5",
"seed": null,
"task_id": "mock_task_id"
}Get RunwayML task status
Check the progress of a RunwayML image or video task and get links to the finished files when ready.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | The task ID returned when the image or video was created. |
Response
{
"created_at": "2025-01-01T00:00:00Z",
"output": [
"https://example.com/asset.mp4"
],
"status": "SUCCEEDED",
"task_id": "mock_task_id"
}