# Amazon Nova Reel

<!-- meta: type=aws-nova-reel; location=Generative Video; category=AI; platforms=Joomla and WordPress (where applicable) -->

## Overview

Amazon Nova Reel is a **AI** in **Generative Video**. Generates video from a text prompt using Amazon Nova Reel on Bedrock.

When the flow reaches this step, JOrchestrator calls the configured model using credentials from **Node Configuration**, then exposes the response fields listed below to downstream steps.

## Why use this node

Amazon Nova Reel is a **AI step** in the **Generative Video** group. AI steps call language or media models. Use them to generate text, classify content, or produce assets that later steps publish or send.

Typical reasons teams add **Amazon Nova Reel** to a flow:

- Generate or transform content with Amazon Nova Reel before publishing or sending
- Use upstream CMS or webhook fields as prompts or context
- Keep AI calls inside audited, repeatable flows rather than one-off scripts

## Example workflows

Common patterns on the canvas:

1. **Trigger or Webhook** → upstream steps → **Amazon Nova Reel** → **Send Email** or CMS update
2. **Scheduled trigger** → **Amazon Nova Reel** → **Debug** (while testing) → production action

## How to set it up

Credentials from Node Configuration → AWS; s3:// output URI required.

## Good to know

Requires model access in Bedrock and bedrock:InvokeModel permission.

## Properties panel

The designer shows these tabs for this node:

| Tab | Purpose |
|-----|---------|
| **Info** | Plain-language description and output payload fields for downstream steps |
| **General** | Canvas label and read-only node ID |
| **AI** | Optional assistant to help draft settings from plain language |
| **Design** | Node-specific configuration fields |

### System (automatic — not edited by the user)

These fields are managed by the designer or runtime — you do not type into them directly:

| Property key | Label | Type | Required | Visible when | Notes |
|--------------|-------|------|----------|--------------|-------|
| `_nodeId` | Node ID | `node-id` | No | — | — |
| `_payloadFields` | Available Fields | `payload-panel` | No | — | — |

### User-configured — General tab

| Property key | Label | Type | Required | Visible when | Notes |
|--------------|-------|------|----------|--------------|-------|
| `label` | Label | `text` | No | — | Node label |

### User-configured — Design tab

| Property key | Label | Type | Required | Visible when | Notes |
|--------------|-------|------|----------|--------------|-------|
| `prompt` | Prompt | `textarea` | **Yes** | — | Describe the video to generate… |
| `outputS3Uri` | Output S3 URI | `payload-text` | **Yes** | — | s3://my-bucket/nova-reel-output/ S3 folder where Bedrock writes the generated MP4. Your AWS credentials must allow bedrock:InvokeModel and S3 write access. |
| `region` | Bedrock region | `select` (`us-east-1` \| `eu-west-1` \| `ap-northeast-1`; default: `us-east-1`) | No | — | Leave default unless your AWS config uses another region. Nova Reel v1.1 is only in us-east-1. |
| `modelId` | Nova Reel model | `select` (`amazon.nova-reel-v1:0` \| `amazon.nova-reel-v1:1`; default: `amazon.nova-reel-v1:0`) | No | — | — |
| `durationSeconds` | Duration (seconds) | `select` (`6` \| `12` \| `18` \| `24` \| `30` \| `60` \| `120`; default: `6`) | No | — | — |
| `dimension` | Resolution | `select` (`1280x720`; default: `1280x720`) | No | — | — |
| `fps` | FPS | `select` (`24`; default: `24`) | No | — | — |
| `seed` | Seed (0 = random) | `payload-text` (default: `0`) | No | — | 0 |
| `pollIntervalSeconds` | Poll interval (seconds) | `select` (`10` \| `15` \| `30`; default: `15`) | No | — | — |
| `maxPollMinutes` | Max wait (minutes) | `select` (`5` \| `10` \| `15` \| `20` \| `30`; default: `15`) | No | — | — |

### CMS site configuration (not on this node's properties panel)

Credentials, API keys, mailers, SMTP, and integration defaults are configured in the CMS plugin under **Node Configuration**, not per step on this node. Link the flow to a domain before testing CMS-backed fields.

## Output payload fields

After this step runs, later nodes can reference these fields using placeholders such as
`{{amazon_nova_reel.success}}`.

| Field key | Type | Description |
|-----------|------|-------------|
| `success` | boolean | Whether the operation completed successfully. |
| `region` | string | AWS region used for the request. |
| `modelId` | string | AI or video model identifier used. |
| `invocationArn` | string | Bedrock async invocation ARN. |
| `outputS3Uri` | string | S3 URI of generated output. |
| `resultS3Uri` | string | S3 URI of the final video result. |
| `videoUri` | string | Provider API file URI (requires API key to download directly). |
| `status` | string | HTTP status code or operation status string. |
| `pollAttempts` | number | Number of times the node polled for completion. |
| `message` | string | Human-readable status, error, or result summary. |

## Validation rules

- **Prompt** (`prompt`) must be filled before the flow can be saved.
- **Output S3 URI** (`outputS3Uri`) must be filled before the flow can be saved.

## Related nodes

Other steps in the same area of the palette:

- **Google Veo** (`google-veo`) — Generative Video
