RunwayML
API actions for the RunwayML integration.
RunwayML
Create images and videos with RunwayML and monitor generation tasks.
Generate image with RunwayML
Create an image from a text prompt using RunwayML (async task).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt_text | string | Yes | The text prompt describing the desired image (1-1000 chars). |
model | string | No | Model identifier (gen4_image_turbo, gen4_image, or gemini_2.5_flash). Defaults to gen4_image_turbo. |
ratio | string | No | Aspect ratio such as 1024:1024 or 1920:1080. Defaults to 1024:1024. |
seed | number | No | Optional integer seed (0-4294967295) for reproducibility. |
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 (async task).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt_text | string | Yes | The text prompt describing the desired video. |
model | string | No | RunwayML model identifier (e.g. gen4.5, veo3.1). Defaults to gen4.5. |
ratio | string | No | Aspect ratio (1280:720 or 720:1280). Defaults to 1280:720. |
duration | number | No | Duration in seconds (5 or 10). Defaults to 5. |
seed | number | No | Optional integer seed for reproducibility. |
Response
{
"model": "gen4.5",
"seed": null,
"task_id": "mock_task_id"
}Get RunwayML task status
Check the status of a RunwayML generation task and fetch output URLs when ready.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | The RunwayML task identifier to look up. |
Response
{
"created_at": "2025-01-01T00:00:00Z",
"output": [
"https://example.com/asset.mp4"
],
"status": "SUCCEEDED",
"task_id": "mock_task_id"
}