## Basic model info

Model name: runwayml/gen4-image
Model description: Runway's Gen-4 Image model with references. Use up to 3 reference images to create the exact image you need. Capture every angle.


## Model inputs

- aspect_ratio (optional): Image aspect ratio (string)
- resolution (optional): Image resolution (string)
- seed (optional): Random seed. Set for reproducible generation (integer)
- prompt (required): Text prompt for image generation (string)
- reference_tags (optional): An optional tag for each of your reference images. Tags must be alphanumeric and start with a letter. You can reference them in your prompt using @tag_name. Tags must be between 3 and 15 characters. (array)
- reference_images (optional): Up to 3 reference images. Images must be between 0.5 and 2 aspect ratio. (array)


## Model output schema

{
  "type": "string",
  "title": "Output",
  "format": "uri"
}

If the input or output schema includes a format of URI, it is referring to a file.


## Example inputs and outputs

Use these example outputs to better understand the types of inputs the model accepts, and the types of outputs the model returns:

### Example (https://replicate.com/p/mywmh37rrnrme0cqpbzs5wq2wm)

#### Input

```json
{
  "prompt": "a close up portrait of @woman, she is standing on stage in the middle of giving a tech talk at a large conference",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "woman"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NGEXyNlRyT6OFrrscxAae4lLm6PJTOKjjvYTrfJljtUuQdVL/0_1%20copy.jpg"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/oQpTo6WK0IJnPxXHJGmf6ctgzNhifKKVDXwvQgZfvuQlfqsTB/tmpoz5pix9w.png"
```


### Example (https://replicate.com/p/yz95jxx401rme0cqpc4byr9wfr)

#### Input

```json
{
  "prompt": "a @woman and @robot are lounging on the sofa in @living_room, it is evening and low light",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "woman",
    "robot",
    "living_room"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NGEXyNlRyT6OFrrscxAae4lLm6PJTOKjjvYTrfJljtUuQdVL/0_1%20copy.jpg",
    "https://replicate.delivery/pbxt/NGEjAt5lSCladsFCWtG6j5hcBvpRnqfhy1DPS4HSPjlDjW5W/out-0.webp",
    "https://replicate.delivery/pbxt/NGEjBFBUKPjuDeiOhCsQTFPUnAC1cElJClWuyit8hPmSIZPo/out-0-1.webp"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/SMDL9lmvAN5BJR67DnLH5XoA7FIw9DQrfSOQHbEwHRPacldKA/tmp5cn7gma6.png"
```


### Example (https://replicate.com/p/qf9rq3w6hsrm80cqpc6amspf1w)

#### Input

```json
{
  "prompt": "a close up portrait of @woman, she is lounging on the sofa in @living_room, it is evening and low light, she is watching TV and the screen illuminates her, seen from a side angle",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "woman",
    "living_room"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NGEXyNlRyT6OFrrscxAae4lLm6PJTOKjjvYTrfJljtUuQdVL/0_1%20copy.jpg",
    "https://replicate.delivery/pbxt/NGEnCSuHibqiu5cAz5UjXZ8xg8lpX5mfq5uxKphjPXsj4yTB/out-0-1.webp"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/q2oMYH2OCUqpPxaItI8DxiUy8W4TZWuRTxlNeOY2cLkXeK7UA/tmpuewzj13o.png"
```


### Example (https://replicate.com/p/vz9ea6bj9hrme0cqpc6tn8kp3g)

#### Input

```json
{
  "prompt": "a top down isometric view of @living_room",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "living_room"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NGEoA3VhskF4Od2Nr77VNf5GWcVK2NFNiwBz1BOJM08H3eg6/out-0-1.webp"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/h8kHrlvwy9YeHCzJCU1wFTAGNvFZuJkNTGEA0encd8Qm9K7UA/tmp9h2xotyk.png"
```


### Example (https://replicate.com/p/qv6zqqvx2srma0cqpcasyreff4)

#### Input

```json
{
  "prompt": "@woman holds the @bottom up, the bottle is the subject, the @woman is visible but she is blurred, she is in the @living_room, it is a product photo shoot",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "woman",
    "living_room",
    "bottle"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NGEXyNlRyT6OFrrscxAae4lLm6PJTOKjjvYTrfJljtUuQdVL/0_1%20copy.jpg",
    "https://replicate.delivery/pbxt/NGEjBFBUKPjuDeiOhCsQTFPUnAC1cElJClWuyit8hPmSIZPo/out-0-1.webp",
    "https://replicate.delivery/pbxt/NGEwT9L6uVgjNs2vCuI9y9r8D8L0IfjwMIkhTF5KZT9w5qmF/mbt8w0cw15rm80cqpc8anzdt20.jpg"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/B876lnYuH5pGNVYdvcnFWXtUcCJfgd2HffJaDI89bTM8LW2pA/tmpg3f4r0in.png"
```


### Example (https://replicate.com/p/jznr8ntjdhrme0cqrp1tmbpw50)

#### Input

```json
{
  "prompt": "a close up portrait of @woman and @man standing in @park, hands in pockets, looking cool. She is wearing her pink sweater and bangles.",
  "resolution": "1080p",
  "aspect_ratio": "4:3",
  "reference_tags": [
    "park",
    "woman",
    "man"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NHVhGWPplgrmOE8EGTVhbeSqWuZBcZLHyMQrgrTH4Hpa1ljU/m4hjkmbk79rma0cqrnxt67cqnw.jpg",
    "https://replicate.delivery/pbxt/NHVhFhdxAAmuXKUyT4r10KIalYrXf9vp5B40CmAeXlPieuOs/w99em95b01rmc0cqrny8chf49w.jpg",
    "https://replicate.delivery/pbxt/NHVhGE5GSJlAfL9RkGFvUbx70KVl7l7KamUNLHOAUd1sQVuF/psjdbkzgm1rmc0cqrnysbg93cm.jpg"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/eWbp1p7iKZzLS65MUKRpWSvHwQVrjpf9kbm98CsWfXAJKt4pA/tmpq55tt0im.png"
```


### Example (https://replicate.com/p/xme95s10mhrma0cqrsrayrdh1w)

#### Input

```json
{
  "prompt": "show me the man from @img_1 framed through the windshield of a car like the reference @img_2",
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_tags": [
    "img_1",
    "img_2"
  ],
  "reference_images": [
    "https://replicate.delivery/pbxt/NHYyvX67znxq0fgkyHGxk3fKDxGEeyeZspv2Ovx8mA1I6rh3/cinematic-man.jpg",
    "https://replicate.delivery/pbxt/NHYyw0KqhQ2tMipLTN20atatluUV7uWwyMEJ1bFksVY2fUVR/car-drawing.jpg"
  ]
}
```

#### Output

```json
"https://replicate.delivery/xezq/sNEFCey4l8w6bqhPBnOogYBPpxa2rIVT1tDI2CwLf7ZnXa8UA/tmp328jhgmu.png"
```


## Model readme

> # Gen-4 Image with references
> 
> A reference-based image generation model that maintains character and location consistency across generations.
> 
> When attributing to Runway, please use “Powered by Runway” and link to runwayml.com from the user interface.
> 
> - [Usage policy](https://help.runwayml.com/hc/en-us/articles/17944787368595-Runway-s-Usage-Policy)
> - [Terms of use](https://runwayml.com/terms-of-use)
> - [Privacy policy](https://runwayml.com/privacy-policy)
> 
> ## Overview
> 
> Gen-4 Image with references enables generation of consistent characters and locations using 1-3 reference images. The model preserves visual identity while allowing transformation of lighting, poses, settings, and styling through text prompts.
> 
> ## Core Features
> 
> - Character preservation: Maintain facial features and identity across different scenes
> - Location consistency: Generate multiple angles and shots of the same environment  
> - Multi-reference support: Use up to 3 reference images per generation
> - Conversational prompting: Natural language descriptions with iterative refinement
> 
> ## Optimal reference images
> 
> - Natural, even lighting (avoid harsh shadows)
> - Neutral expressions for maximum flexibility
> - Moderate to high quality
> - Clear subject visibility
> 
> ## Usage Patterns
> 
> ### Single Reference
> 
> Use text prompts to describe transformations while preserving character identity.
> 
> ```
> @character_name wearing a leather jacket in a cyberpunk city
> ```
> 
> ### Multi-Reference
> 
> Combine character and scene references for precise control.
> 
> ```
> @character sitting in @location with dramatic lighting
> ```
> 
> ### Scene Generation
> 
> Create consistent environments from different angles.
> 
> ```
> show the castle courtyard from above
> wide shot of the same location at sunset  
> ```
> 
> ## Advanced Workflows
> 
> - Iterative refinement: Use generated outputs as new references to build complex scenes step-by-step.
> - Separate pathways: Develop character and environment references independently, then combine.
> - Element isolation: Generate specific clothing, poses, or lighting setups as references for final compositions.
> 
> ![](https://runway-static-assets.s3.amazonaws.com/site/images/api-page/powered-by-runway-black.png)