> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# runwayml

> Runway - AI-powered video and image generation (gen4_turbo, gen4_image, upscale)

**Server path:** `/runwayml` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                      | Description                          |
| --------------------------------------------------------- | ------------------------------------ |
| [`runwayml_cancel_task`](#runwayml_cancel_task)           | Cancel a task                        |
| [`runwayml_edit_video`](#runwayml_edit_video)             | Edit a video with a prompt           |
| [`runwayml_get_organization`](#runwayml_get_organization) | Get organization info                |
| [`runwayml_get_task`](#runwayml_get_task)                 | Get task status and result           |
| [`runwayml_image_to_video`](#runwayml_image_to_video)     | Generate a video from an image       |
| [`runwayml_text_to_image`](#runwayml_text_to_image)       | Generate an image from a text prompt |
| [`runwayml_upscale_video`](#runwayml_upscale_video)       | Upscale a video                      |

***

## runwayml\_cancel\_task

Cancel a task

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `taskId`  | string | Yes      | —       | The task ID to cancel |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "taskId": {
        "type": "string",
        "description": "The task ID to cancel"
      }
    },
    "required": [
      "PCID",
      "taskId"
    ]
  }
  ```
</Expandable>

***

## runwayml\_edit\_video

Edit a video with a prompt

**Parameters:**

| Parameter    | Type      | Required | Default | Description                                             |
| ------------ | --------- | -------- | ------- | ------------------------------------------------------- |
| `model`      | string    | Yes      | —       | Model to use for video editing                          |
| `promptText` | string    | Yes      | —       | Text prompt describing the desired video transformation |
| `ratio`      | string    | No       | —       | Output video aspect ratio                               |
| `references` | object\[] | No       | —       | Optional reference images to guide style or content     |
| `videoUri`   | string    | Yes      | —       | Source video as a URL or data URI                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "model": {
        "type": "string",
        "description": "Model to use for video editing",
        "enum": [
          "gen4_aleph"
        ]
      },
      "promptText": {
        "type": "string",
        "description": "Text prompt describing the desired video transformation"
      },
      "ratio": {
        "type": "string",
        "description": "Output video aspect ratio",
        "enum": [
          "1280:720",
          "720:1280",
          "1104:832",
          "960:960",
          "832:1104",
          "1584:672",
          "848:480",
          "640:480"
        ]
      },
      "references": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "uri": {
              "type": "string",
              "description": "Reference image as a URL or base64-encoded data URI"
            },
            "tag": {
              "type": "string",
              "description": "Optional tag to identify the reference image role"
            }
          },
          "required": [
            "uri"
          ]
        },
        "description": "Optional reference images to guide style or content"
      },
      "videoUri": {
        "type": "string",
        "description": "Source video as a URL or data URI"
      }
    },
    "required": [
      "PCID",
      "model",
      "promptText",
      "videoUri"
    ]
  }
  ```
</Expandable>

***

## runwayml\_get\_organization

Get organization info

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## runwayml\_get\_task

Get task status and result

**Parameters:**

| Parameter | Type   | Required | Default | Description                                    |
| --------- | ------ | -------- | ------- | ---------------------------------------------- |
| `taskId`  | string | Yes      | —       | The task ID returned from a generation request |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "taskId": {
        "type": "string",
        "description": "The task ID returned from a generation request"
      }
    },
    "required": [
      "PCID",
      "taskId"
    ]
  }
  ```
</Expandable>

***

## runwayml\_image\_to\_video

Generate a video from an image

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                        |
| ------------- | ------- | -------- | ------- | -------------------------------------------------- |
| `duration`    | integer | No       | —       | Video duration in seconds (5 or 10)                |
| `model`       | string  | Yes      | —       | Model to use for generation                        |
| `promptImage` | string  | Yes      | —       | Source image as a URL or base64-encoded data URI   |
| `promptText`  | string  | Yes      | —       | Optional text prompt to guide the video generation |
| `ratio`       | string  | No       | —       | Output video aspect ratio                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "duration": {
        "type": "integer",
        "description": "Video duration in seconds (5 or 10)",
        "enum": [
          5,
          10
        ]
      },
      "model": {
        "type": "string",
        "description": "Model to use for generation",
        "enum": [
          "gen4_turbo",
          "gen3a_turbo"
        ]
      },
      "promptImage": {
        "type": "string",
        "description": "Source image as a URL or base64-encoded data URI"
      },
      "promptText": {
        "type": "string",
        "description": "Optional text prompt to guide the video generation"
      },
      "ratio": {
        "type": "string",
        "description": "Output video aspect ratio",
        "enum": [
          "1280:720",
          "720:1280",
          "1104:832",
          "832:1104",
          "960:960",
          "1584:672"
        ]
      }
    },
    "required": [
      "PCID",
      "model",
      "promptImage",
      "promptText"
    ]
  }
  ```
</Expandable>

***

## runwayml\_text\_to\_image

Generate an image from a text prompt

**Parameters:**

| Parameter         | Type      | Required | Default | Description                                         |
| ----------------- | --------- | -------- | ------- | --------------------------------------------------- |
| `model`           | string    | Yes      | —       | Model to use for generation                         |
| `promptText`      | string    | Yes      | —       | Text prompt describing the image to generate        |
| `ratio`           | string    | No       | —       | Output image aspect ratio                           |
| `referenceImages` | object\[] | No       | —       | Optional reference images to guide style or content |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "model": {
        "type": "string",
        "description": "Model to use for generation",
        "enum": [
          "gen4_image",
          "gen4_image_turbo",
          "gemini_2.5_flash",
          "gemini_3_pro"
        ]
      },
      "promptText": {
        "type": "string",
        "description": "Text prompt describing the image to generate"
      },
      "ratio": {
        "type": "string",
        "description": "Output image aspect ratio",
        "enum": [
          "1920:1080",
          "1080:1920",
          "1024:1024",
          "1360:768",
          "1080:1080",
          "1168:880",
          "1440:1080",
          "1080:1440",
          "1808:768",
          "2112:912",
          "1280:720",
          "720:1280",
          "720:720",
          "960:720",
          "720:960",
          "1680:720"
        ]
      },
      "referenceImages": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "uri": {
              "type": "string",
              "description": "Reference image as a URL or base64-encoded data URI"
            },
            "tag": {
              "type": "string",
              "description": "Optional tag to identify the reference image role"
            }
          },
          "required": [
            "uri"
          ]
        },
        "description": "Optional reference images to guide style or content"
      }
    },
    "required": [
      "PCID",
      "model",
      "promptText"
    ]
  }
  ```
</Expandable>

***

## runwayml\_upscale\_video

Upscale a video

**Parameters:**

| Parameter  | Type   | Required | Default | Description                       |
| ---------- | ------ | -------- | ------- | --------------------------------- |
| `model`    | string | Yes      | —       | Model to use for upscaling        |
| `videoUri` | string | Yes      | —       | Source video as a URL or data URI |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "model": {
        "type": "string",
        "description": "Model to use for upscaling",
        "enum": [
          "upscale_v1"
        ]
      },
      "videoUri": {
        "type": "string",
        "description": "Source video as a URL or data URI"
      }
    },
    "required": [
      "PCID",
      "model",
      "videoUri"
    ]
  }
  ```
</Expandable>