Skip to content
Nappai Documentation

Runway Image Generator

Runway Image Generator creates images with Runway image models. You can start from a written description alone or add reference images so the new image is based on them. The component waits until the images are ready and returns them so you can keep working with them in the flow.

Use it to produce marketing images, variants of a product photo or illustrations in series from a list of descriptions.

When to use it

  • Create the image for a post or an ad from the copy of the campaign.
  • Generate new scenes with your product starting from its photo.
  • Prepare versions of the same image in different formats (landscape, portrait, square).
  • Generate one image for each item of a list, for example one per item in a catalogue.
  • Give an agent the ability to create images when a user asks for one.

Configuration

This component needs a credential of the Runway API service. See Credentials to create one.

FieldWhat it does
Credential (required)The credential of the Runway API service.
Generation ModeHow the image is created: text_to_image (from a description) or image_to_image (from a description and reference images).
Image ModelThe Runway model that creates the image. The list depends on Generation Mode: gen4_image or gemini_2.5_flash in text_to_image, and gen4_image_turbo, gen4_image or gemini_2.5_flash in image_to_image (gen4_image_turbo needs at least one reference image). Default: gen4_image.
Aspect RatioImage format: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3 or 3:2. Default: 1:1. Runway draws it at the closest size the chosen model offers (for example 1920:1080 for 16:9 with gen4_image).
Number of ImagesHow many images you want, from 1 to 4. Default: 1. Runway draws one image per request, so each image is a separate request (and is charged as one).
PromptThe description of the image you want, up to 1000 characters. You can type it or connect a text from another component.
Image FilesAppears in image_to_image mode. Connection point for the reference images: image files or their web addresses (URL). All the ones you connect are used.

Advanced options

FieldWhat it does
SeedA number that fixes the starting point of the generation. With the same number and the same settings you get similar results; leave it empty so each image is different.

Batch processing

With the Batch Mode switch on, the component runs once for each item of the list you connect to Batch Input and returns all the results together as a list. Skip if Empty Batch Input skips the component when the list arrives empty, and Skip Branch if Empty Output stops the following components when the result is empty. More in Key concepts.

Using it as an agent tool

You can connect this component to an agent’s Tools input. In the Tool tab, Tool Name and Tool Description are the name and explanation the agent uses to recognise the tool and decide when to call it: write a clear description of what it does.

Output

  • Image: the generated images in PNG format, each with its file name. Pass them to the next components of the flow to save them, send them or keep processing them.
  • Tool: the component as a tool, to connect to an agent’s Tools input. When the agent uses it, each image is saved with the conversation and the agent receives its name and the link to view it.

Example

The online shop Albaida Ceramics wants a staged image for every new piece in its catalogue:

  1. Add Runway Image Generator and choose the Runway API credential.
  2. Choose image_to_image in Generation Mode and one of the models in Image Model.
  3. Connect the photo of the piece to Image Files.
  4. In Prompt, write: “The vase on a light wooden table next to a window, natural morning light, Mediterranean style”.
  5. Choose 4:3 in Aspect Ratio and run the flow. Connect Image to the component that saves or publishes the file.

Good practices

  • Keep the description concrete: the limit is 1000 characters.
  • With reference images, explain what should be kept from them and what should change.
  • Try a single image before turning on Batch Mode with a long list: each image uses your Runway account.