---
title: "Changes to Text/Image to Image"
method: POST
path: "/v1/text_to_image"
---

# Changes to Text/Image to Image

`POST /v1/text_to_image`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 67 revisions.

- **2026-10-23** `48c998a7f98f`: 1 info
- **2026-10-22** `03955b3cb80c`: 1 info
- **2026-10-13** `287adbf67df4`: 1 info
- **2026-10-02** `ef7e1923afaf`: 1 info
- **2026-09-23** `32bf35da4526`: 1 breaking, 1 info
- **2026-09-02** `5e07441c221a`: 17 breaking, 3 info
- **2026-08-28** `569985a25155`: 1 info
- **2026-08-18** `3f3a4647d82f`: 1 info
- **2026-08-07** `73a12c23285c`: 3 info
- **2026-07-21** `2973074ac4a2`: 1 info
- **2026-07-13** `572334d31598`: 1 info
- **2026-06-25** `39fa7be65d80`: 2 info
- **2026-06-02** `bb2963960c9b`: 1 info
- **2026-05-08** `85b7de040761`: 3 info
- **2026-04-30** `1d3bb312672a`: 1 info
- **2025-12-04** `f1f066255f00`: 1 breaking
- **2025-12-04** `6dab1bdab5d3`: 5 info
- **2025-12-03** `c2a88516fa0c`: 1 breaking, 3 info
- **2025-12-03** `76b3962cf49e`: 4 info
- **2025-11-17** `c2a88516fa0c`: 1 breaking, 6 warning, 3 info

## Changes

- **2026-10-23** `48c998a7f98f`: 1 info
  - added `subschema #19: recraft_v4_1_flash, subschema #20: recraft_v4_1_vector` to the request body `oneOf` list
- **2026-10-22** `03955b3cb80c`: 1 info
  - added `subschema #9: gemini_image3.1_flash_lite, subschema #13: bria_fibo_1_5, subschema #14: bria_fibo_edit_1_5, subschema #17: seedream5_flash, subschema #18: nano_banana_2.1` to the request body `oneOf` list
- **2026-10-13** `287adbf67df4`: 1 info
  - added `subschema #12: ideogram_4_0, subschema #13: ideogram_4_5` to the request body `oneOf` list
- **2026-10-02** `ef7e1923afaf`: 1 info
  - added the optional property `reason` to the response with the `400` status
- **2026-09-23** `32bf35da4526`: 1 breaking, 1 info
  - the `oneOf[subschema #4: gemini_image3_pro -> subschema #9: gemini_image3_pro]/promptText` request property's minLength was increased from `1` to `3`
  - added `subschema #10: gpt_image_2_5_flare, subschema #11: gpt_image_2_5_sunburst` to the request body `oneOf` list
- **2026-09-02** `5e07441c221a`: 17 breaking, 3 info
  - removed the enum value `1600:2848` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `1664:2496` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `1728:2304` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2048:2048` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2304:1728` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2304:4096` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2496:1664` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2496:3744` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2592:3456` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `2848:1600` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `3072:3072` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `3136:1344` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `3456:2592` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `3744:2496` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `4096:2304` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - removed the enum value `4704:2016` of the request property `oneOf[subschema #8: seedream5_lite]/ratio`
  - the `oneOf[subschema #8: seedream5_lite]/ratio` request property type changed from `string` to no type
  - added the new optional request property `oneOf[subschema #6: muse_image]/outputFormat`
  - added `subschema #1, subschema #2` to the `oneOf[subschema #8: seedream5_lite]/ratio` request property `anyOf` list
  - added the new `transparent` enum value to the request property `oneOf[subschema #3: gpt_image_2]/background`
- **2026-08-28** `569985a25155`: 1 info
  - added `subschema #6: muse_image` to the request body `oneOf` list
- **2026-08-18** `3f3a4647d82f`: 1 info
  - added `subschema #8: grok_imagine_image_2` to the request body `oneOf` list
- **2026-08-07** `73a12c23285c`: 3 info
  - added the new optional request property `oneOf[subschema #7: seedream5_lite]/grounding`
  - added the non-success response with the status `400`
  - added the required property `estimatedCost` to the response with the `200` status
- **2026-07-21** `2973074ac4a2`: 1 info
  - added the new optional request property `oneOf[subschema #6: seedream5_pro]/grounding`
- **2026-07-13** `572334d31598`: 1 info
  - added `subschema #6: seedream5_pro, subschema #7: seedream5_lite` to the request body `oneOf` list
- **2026-06-25** `39fa7be65d80`: 2 info
  - the `oneOf[subschema #5: gemini_image3.1_flash]/promptText` request property's maxLength was increased from `1000` to `5500`
  - the `oneOf[subschema #6: gemini_2.5_flash]/promptText` request property's maxLength was increased from `1000` to `5500`
- **2026-06-02** `bb2963960c9b`: 1 info
  - added `subschema #5: gemini_image3.1_flash` to the request body `oneOf` list
- **2026-05-08** `85b7de040761`: 3 info
  - added `subschema #3: gpt_image_2` to the request body `oneOf` list
  - the request property `oneOf[subschema #3: gemini_image3_pro -> subschema #4: gemini_image3_pro]/referenceImages/items/subject` became optional
  - the `subject` request property default value `object` was added
- **2026-04-30** `1d3bb312672a`: 1 info
  - added `subschema #3: gemini_image3_pro` to the request body `oneOf` list
- **2025-12-04** `f1f066255f00`: 1 breaking
  - removed `subschema #3: gemini_3_pro` from the request body `oneOf` list
- **2025-12-04** `6dab1bdab5d3`: 5 info
  - added `subschema #3: gemini_3_pro` to the request body `oneOf` list
  - the `model` request property default value `gemini_2.5_flash` was removed
  - the `model` request property default value `gen4_image` was removed
  - the `model` request property default value `gen4_image_turbo` was removed
  - added the media type `application/json` for the response with the status `429`
- **2025-12-03** `c2a88516fa0c`: 1 breaking, 3 info
  - removed `subschema #3: gemini_3_pro` from the request body `oneOf` list
  - the `model` request property default value `gemini_2.5_flash` was added
  - the `model` request property default value `gen4_image` was added
  - the `model` request property default value `gen4_image_turbo` was added
- **2025-12-03** `76b3962cf49e`: 4 info
  - added `subschema #3: gemini_3_pro` to the request body `oneOf` list
  - the `model` request property default value `gemini_2.5_flash` was removed
  - the `model` request property default value `gen4_image` was removed
  - the `model` request property default value `gen4_image_turbo` was removed
- **2025-11-17** `c2a88516fa0c`: 1 breaking, 6 warning, 3 info
  - the request's body type changed from `object` to no type
  - removed the request property `contentModeration`
  - removed the request property `model`
  - removed the request property `promptText`
  - removed the request property `ratio`
  - removed the request property `referenceImages`
  - removed the request property `seed`
  - added request discriminator
  - added `subschema #1: gen4_image_turbo, subschema #2: gen4_image, subschema #3: gemini_2.5_flash` to the request body `oneOf` list
  - the `id` response's property pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` was added for the status `200`

---

[Operation](https://skmtc.dev/runwayml/apis/runwayml-api/docs/v1/text_to_image/post.md) - [API](https://skmtc.dev/runwayml/apis/runwayml-api.md) - [Page](https://skmtc.dev/runwayml/apis/runwayml-api/changes/v1/text_to_image/post)
