---
title: "Changes to Create Embeddings"
method: POST
path: "/v1/embeddings"
---

# Changes to Create Embeddings

`POST /v1/embeddings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-09-21** `5fdbd3614b8c`: 1 info
- **2026-08-20** `0db3023472ef`: 1 breaking, 3 info
- **2026-07-11** `0fd1d281f985`: 5 breaking, 3 warning, 11 info
- **2026-04-30** `d5f1d3d5614e`: 3 breaking, 3 info
- **2026-03-24** `50ec08f1fdf6`: 2 breaking, 10 info
- **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info
- **2026-03-04** `618db9823ac3`: 2 breaking, 6 info
- **2026-03-04** `46bc88767a37`: 5 breaking, 2 warning, 15 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 1 info
  - added the optional property `usage/prompt_tokens_details` to the response with the `200` status
- **2026-08-20** `0db3023472ef`: 1 breaking, 3 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `input` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `input` request property `anyOf` list
  - the request property `input` became optional
  - the `input` request property's minLength was decreased from `1` to `0`
- **2026-07-11** `0fd1d281f985`: 5 breaking, 3 warning, 11 info
  - the `input/anyOf[subschema #2]/items/` request property's minItems was increased to `1`
  - the `input` request property's minLength was increased from `0` to `1`
  - the `model` request property's minLength was increased from `0` to `1`
  - response property `id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - the `dimensions/anyOf[subschema #1]/` request property's exclusiveMinimum was set to `0.00`
  - removed the optional property `usage/carbon` from the response with the `200` status
  - removed the optional property `usage/requests` from the response with the `200` status
  - api operation id `embeddings_v1_embeddings_post` removed and replaced with `create_embeddings_v1_embeddings_post`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `headers` to the response with the `422` status
  - the response property `detail` became required for the status `422`
  - the `impacts` response's property default value `{"kWh":0,"kgCO2eq":0}` was added for the status `200`
  - added the required property `status_code` to the response with the `422` status
- **2026-04-30** `d5f1d3d5614e`: 3 breaking, 3 info
  - request property `encoding_format` was restricted to a list of enum values
  - request property `encoding_format` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the response property `object` became optional for the status `200`
  - added the new `base64` enum value to the request property `encoding_format`
  - added the new `float` enum value to the request property `encoding_format`
  - the `object` response's property default value `list` was added for the status `200`
- **2026-03-24** `50ec08f1fdf6`: 2 breaking, 10 info
  - the `usage/carbon/kWh` response's property type changed from `number` to `object` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200`
  - added the optional property `usage/carbon/kWh/max` to the response with the `200` status
  - added the optional property `usage/carbon/kWh/min` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/max` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/min` to the response with the `200` status
  - added the optional property `usage/impacts` to the response with the `200` status
  - the `kWh` response's property default value `0` was removed for the status `200`
  - the `kgCO2eq` response's property default value `0` was removed for the status `200`
  - response property `usage/carbon` deprecated
  - response property `usage/carbon/kWh` deprecated
  - response property `usage/carbon/kgCO2eq` deprecated
- **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info
  - the `usage/carbon/kWh` response's property type changed from `object` to `number` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `object` to `number` for status `200`
  - removed the optional property `usage/carbon/kWh/max` from the response with the `200` status
  - removed the optional property `usage/carbon/kWh/min` from the response with the `200` status
  - removed the optional property `usage/carbon/kgCO2eq/max` from the response with the `200` status
  - removed the optional property `usage/carbon/kgCO2eq/min` from the response with the `200` status
  - the `kWh` response's property default value `0` was added for the status `200`
  - the `kgCO2eq` response's property default value `0` was added for the status `200`
- **2026-03-04** `618db9823ac3`: 2 breaking, 6 info
  - the `usage/carbon/kWh` response's property type changed from `number` to `object` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200`
  - added the optional property `usage/carbon/kWh/max` to the response with the `200` status
  - added the optional property `usage/carbon/kWh/min` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/max` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/min` to the response with the `200` status
  - the `kWh` response's property default value `0` was removed for the status `200`
  - the `kgCO2eq` response's property default value `0` was removed for the status `200`
- **2026-03-04** `46bc88767a37`: 5 breaking, 2 warning, 15 info
  - removed the enum value `base64` of the request property `encoding_format`
  - removed the enum value `float` of the request property `encoding_format`
  - the response property `detail` became optional for the status `422`
  - the `detail` response's property type changed from `string` to `array` for status `422`
  - removed the required property `status_code` from the response with the `422` status
  - removed the optional property `headers` from the response with the `422` status
  - removed the optional property `usage/impacts` from the response with the `200` status
  - api operation id `create_embeddings_v1_embeddings_post` removed and replaced with `embeddings_v1_embeddings_post`
  - request property `encoding_format` list-of-types was widened by adding types `null` to media type `application/json`
  - the `input` request property's minLength was decreased from `1` to `0`
  - the `model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `503`
  - added the optional property `usage/carbon` to the response with the `200` status
  - added the optional property `usage/requests` to the response with the `200` status
  - the response property `object` became required for the status `200`
  - the `object` response's property default value `list` was removed for the status `200`
  - response property `id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

---

[Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/embeddings/post.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/embeddings/post)
