---
title: "Changes to Create a generation"
method: POST
path: "/generations"
---

# Changes to Create a generation

`POST /generations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 13 revisions.

- **2026-08-04** `2135bbde249c`: 1 warning, 3 info
- **2026-07-15** `83f890190435`: 1 info
- **2026-06-23** `abefb03816b7`: 6 info
- **2026-06-11** `4e4486e756c9`: 3 info
- **2026-06-08** `1a4de7fe8bec`: 7 breaking, 4 warning, 10 info
- **2026-05-04** `1eba0307c5e2`: 1 breaking, 2 warning, 2 info
- **2026-05-04** `e42b03014997`: 5 warning, 1 info
- **2026-04-21** `84431d06dff9`: 1 warning
- **2026-04-13** `bd13cf9c2436`: 1 info
- **2026-04-08** `5f5c6d14e902`: 1 info

## Changes

- **2026-08-04** `2135bbde249c`: 1 warning, 3 info
  - added the new `layering` enum value to the `type` response property for the response status `201`
  - added the new optional request property `layering`
  - added the new `layering` enum value to the request property `type`
  - added the optional property `output/items/layer` to the response with the `201` status
- **2026-07-15** `83f890190435`: 1 info
  - the `prompt` request property's minLength was decreased from `1` to `0`
- **2026-06-23** `abefb03816b7`: 6 info
  - added the new optional request property `image_ref/items/file_id`
  - added the new optional request property `source/oneOf[#/components/schemas/ImageRef]/file_id`
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/edit/oneOf[#/components/schemas/VideoEditOptions]/keyframes/items/file_id`
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/end_frame/oneOf[#/components/schemas/ImageRef]/file_id`
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/keyframes/oneOf[subschema #1]/items/file_id`
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/start_frame/oneOf[#/components/schemas/ImageRef]/file_id`
- **2026-06-11** `4e4486e756c9`: 3 info
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/keyframe_indexes`
  - added the new optional request property `video/oneOf[#/components/schemas/VideoOptions]/keyframes`
  - added the new `360p` enum value to the request property `video/oneOf[#/components/schemas/VideoOptions]/resolution/oneOf[#/components/schemas/VideoResolution]/`
- **2026-06-08** `1a4de7fe8bec`: 7 breaking, 4 warning, 10 info
  - the request property `image_ref/items/data` became not nullable
  - the request property `image_ref/items/media_type` became not nullable
  - the request property `image_ref/items/url` became not nullable
  - the request property `source/oneOf[#/components/schemas/ImageRef]/data` became not nullable
  - the request property `source/oneOf[#/components/schemas/ImageRef]/media_type` became not nullable
  - the request property `source/oneOf[#/components/schemas/ImageRef]/url` became not nullable
  - the request property `user_id` became not nullable
  - added the new `ray-3.2` enum value to the `model` response property for the response status `201`
  - added the new `video` enum value to the `type` response property for the response status `201`
  - added the new `video_edit` enum value to the `type` response property for the response status `201`
  - added the new `video_reframe` enum value to the `type` response property for the response status `201`
  - added the new optional request property `image_ref/items/generation_id`
  - added the new optional request property `source/oneOf[#/components/schemas/ImageRef]/generation_id`
  - added the new optional request property `video`
  - added the new `21:9` enum value to the request property `aspect_ratio/oneOf[#/components/schemas/AspectRatio]/`
  - added the new `3:4` enum value to the request property `aspect_ratio/oneOf[#/components/schemas/AspectRatio]/`
  - added the new `4:3` enum value to the request property `aspect_ratio/oneOf[#/components/schemas/AspectRatio]/`
  - added the new `ray-3.2` enum value to the request property `model`
  - added the new `video` enum value to the request property `type`
  - added the new `video_edit` enum value to the request property `type`
  - added the new `video_reframe` enum value to the request property `type`
- **2026-05-04** `1eba0307c5e2`: 1 breaking, 2 warning, 2 info
  - request property `model` was restricted to a list of enum values
  - added the new `uni-1` enum value to the `model` response property for the response status `201`
  - added the new `uni-1-max` enum value to the `model` response property for the response status `201`
  - added the new `uni-1` enum value to the request property `model`
  - added the new `uni-1-max` enum value to the request property `model`
- **2026-05-04** `e42b03014997`: 5 warning, 1 info
  - added the new `corrupt_input` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
  - added the new `image_too_large` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
  - added the new `invalid_request` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
  - added the new `rate_limited` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
  - added the new `unsupported_format` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
  - added the new optional request property `user_id`
- **2026-04-21** `84431d06dff9`: 1 warning
  - added the new `budget_exhausted` enum value to the `failure_code/oneOf[#/components/schemas/GenerationFailureCode]/` response property for the response status `201`
- **2026-04-13** `bd13cf9c2436`: 1 info
  - added the optional property `failure_code` to the response with the `201` status
- **2026-04-08** `5f5c6d14e902`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lumalabs/apis/luma-agents-api/docs/generations/post.md) · [API](https://skmtc.dev/lumalabs/apis/luma-agents-api.md) · [Page](https://skmtc.dev/lumalabs/apis/luma-agents-api/changes/generations/post)