---
title: "Changes to Create Completion"
method: POST
path: "/v1/completions"
---

# Changes to Create Completion

`POST /v1/completions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 28 revisions.

- **2026-10-16** `3bf245180173`: 26 info
- **2026-04-22** `29a1e4db152c`: 7 info
- **2026-01-27** `80bec85988ad`: 8 warning, 1 info
- **2025-12-22** `60788e5619b0`: 1 info
- **2025-12-16** `f76a6182f2d5`: 1 warning
- **2025-12-09** `3cece9a35f26`: 5 info
- **2025-12-01** `4506ec9d12ff`: 1 info

## Changes

- **2026-10-16** `3bf245180173`: 26 info
  - added the new optional request property `prediction/anyOf[subschema #1: PredictedOutput]/content/anyOf[subschema #2]/items/image_url/anyOf[subschema #1: ChatMessageContentImageURL]/max_long_side_pixel`
  - added the new optional request property `prediction/anyOf[subschema #1: PredictedOutput]/content/anyOf[subschema #2]/items/video_url/anyOf[subschema #1: ChatMessageContentVideoURL]/fps`
  - added the new optional request property `prediction/anyOf[subschema #1: PredictedOutput]/content/anyOf[subschema #2]/items/video_url/anyOf[subschema #1: ChatMessageContentVideoURL]/max_long_side_pixel`
  - added the new optional request property `sampling_mask`
  - added the new optional request property `stream_options`
  - added the new optional request property `thinking/anyOf[subschema #1: ThinkingConfigEnabled]/budget_end_str`
  - added the new optional request property `thinking/anyOf[subschema #1: ThinkingConfigEnabled]/effort`
  - added the new optional request property `thinking/anyOf[subschema #1: ThinkingConfigEnabled]/keep`
  - added `#/components/schemas/ThinkingConfigAdaptive` to the `thinking` request property `anyOf` list
  - the request property `thinking/anyOf[subschema #1: ThinkingConfigEnabled]/type` became optional
  - the `type` request property default value `enabled` was added
  - added the new `adaptive` enum value to the request property `reasoning_effort/anyOf[subschema #1]/`
  - added the new `max` enum value to the request property `reasoning_effort/anyOf[subschema #1]/`
  - added the new `xhigh` enum value to the request property `reasoning_effort/anyOf[subschema #1]/`
  - added the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/sampling_mask` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/sampling_mask` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/sampling_mask_count` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/sampling_mask_count` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/sampling_mask` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/sampling_mask` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/sampling_mask_count` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/sampling_mask_count` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `usage/anyOf[subschema #1: UsageInfo]/completion_tokens_details` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `usage/anyOf[subschema #1: UsageInfo]/output_tokens_details` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `usage/completion_tokens_details` to the response with the `200` status (media type: application/json)
  - added the optional property `usage/output_tokens_details` to the response with the `200` status (media type: application/json)
- **2026-04-22** `29a1e4db152c`: 7 info
  - added the new optional request property `prediction/anyOf[subschema #1: PredictedOutput]/content/anyOf[subschema #2]/items/video_url`
  - added the new optional request property `prompt_cache_key`
  - added the new optional request property `service_tier`
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/videos` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/videos` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-27** `80bec85988ad`: 8 warning, 1 info
  - removed the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/extra_logprobs` from the response with the `200` status (media type: application/json)
  - removed the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/extra_logprobs` from the response with the `200` status (media type: text/event-stream)
  - removed the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/extra_tokens` from the response with the `200` status (media type: application/json)
  - removed the optional property `choices/items/logprobs/anyOf[subschema #2: NewLogProbs]/content/items/extra_tokens` from the response with the `200` status (media type: text/event-stream)
  - removed the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/extra_logprobs` from the response with the `200` status (media type: application/json)
  - removed the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/extra_logprobs` from the response with the `200` status (media type: text/event-stream)
  - removed the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/extra_tokens` from the response with the `200` status (media type: application/json)
  - removed the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/completion_logprobs/anyOf[subschema #1: NewLogProbs]/content/items/extra_tokens` from the response with the `200` status (media type: text/event-stream)
  - added the new optional request property `thinking`
- **2025-12-22** `60788e5619b0`: 1 info
  - added the new optional request property `reasoning_history`
- **2025-12-16** `f76a6182f2d5`: 1 warning
  - removed the request property `prompt_cache_max_len`
- **2025-12-09** `3cece9a35f26`: 5 info
  - request property `reasoning_effort` list-of-types was widened by adding types `boolean` to media type `application/json`
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/grammar` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/grammar` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/images` to the response with the `200` status (media type: application/json)
  - added the optional property `choices/items/raw_output/anyOf[subschema #1: RawOutput]/images` to the response with the `200` status (media type: text/event-stream)
- **2025-12-01** `4506ec9d12ff`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/docs/v1/completions/post.md) - [API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [Page](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/completions/post)