---
title: "Changes to Influence the composition of generated images using a reference image"
method: POST
path: "/v3/ai/image-generations/influence-composition-by-image"
---

# Changes to Influence the composition of generated images using a reference image

`POST /v3/ai/image-generations/influence-composition-by-image`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 16 revisions.

- **2026-08-13** `d069958d92a6`: 3 info
- **2026-06-08** `410649649a3f`: 3 warning
- **2026-02-08** `ade6d268ff0b`: 3 warning
- **2025-11-20** `81cb0e852242`: 1 breaking, 3 warning
- **2025-03-07** `328d929c7310`: 1 info
- **2024-11-23** `f751fa2a43c9`: 1 info

## Changes

- **2026-08-13** `d069958d92a6`: 3 info
  - added the new optional request property `aspect_ratio` (media type: application/json)
  - added the new optional request property `aspect_ratio` (media type: text/json)
  - added the new optional request property `aspect_ratio` (media type: application/*+json)
- **2026-06-08** `410649649a3f`: 3 warning
  - removed the request property `influence_level` (media type: application/json)
  - removed the request property `influence_level` (media type: text/json)
  - removed the request property `influence_level` (media type: application/*+json)
- **2026-02-08** `ade6d268ff0b`: 3 warning
  - removed the request property `seed` (media type: application/json)
  - removed the request property `seed` (media type: text/json)
  - removed the request property `seed` (media type: application/*+json)
- **2025-11-20** `81cb0e852242`: 1 breaking, 3 warning
  - removed the success response with the status `200`
  - removed the request property `negative_prompt` (media type: application/json)
  - removed the request property `negative_prompt` (media type: text/json)
  - removed the request property `negative_prompt` (media type: application/*+json)
- **2025-03-07** `328d929c7310`: 1 info
  - added the non-success response with the status `409`
- **2024-11-23** `f751fa2a43c9`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/ai/image-generations/influence-composition-by-image/post.md) - [API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [Page](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/ai/image-generations/influence-composition-by-image/post)