Create a Text Completion

----
-title: Create a Text Completion
-url: https://platform.claude.com/docs/en/api/completions/create
----
+# Create a Text Completion
 
-## Create a Text Completion
+**POST** `/v1/complete`
 
-**post** `/v1/complete`
-
 [Legacy] Create a Text Completion.
 
 The Text Completions API is a legacy API. We recommend using the [Messages API](https://platform.claude.com/docs/en/api/messages) going forward.

 
 Future models and features will not be compatible with Text Completions. See our [migration guide](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) for guidance in migrating from Text Completions to Messages.
 
-### Header Parameters
+## Headers
 
 - `"anthropic-beta": optional array of AnthropicBeta`
 

 
     - `"mid-conversation-tool-changes-2026-07-01"`
 
-### Body Parameters
+## Body parameters
 
 - `max_tokens_to_sample: number`
 

 
   Note that our models may stop _before_ reaching this maximum. This parameter only specifies the absolute maximum number of tokens to generate.
 
+  minimum: 1
+
 - `model: Model`
 
   The model that will complete your prompt.

 
   See [prompt validation](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) and our guide to [prompt design](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview) for more details.
 
+  minLength: 1
+
 - `metadata: optional Metadata`
 
   An object describing metadata about the request.

 
     This should be a uuid, hash value, or other opaque identifier. Anthropic may use this id to help detect abuse. Do not include any identifying information such as name, email address, or phone number.
 
+    maxLength: 512
+
 - `stop_sequences: optional array of string`
 
   Sequences that will cause the model to stop generating.

 
 - `temperature: optional number`
 
+  **Deprecated**: Deprecated. Models released after Claude Opus 4.6 do not support setting temperature. A value of 1.0 of will be accepted for backwards compatibility, all other values will be rejected with a 400 error.
+
   Amount of randomness injected into the response.
 
   Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0` for analytical / multiple choice, and closer to `1.0` for creative and generative tasks.

 
   Note that even with `temperature` of `0.0`, the results will not be fully deterministic.
 
+  maximum: 1, minimum: 0
+
 - `top_k: optional number`
 
+  **Deprecated**: Deprecated. Models released after Claude Opus 4.6 do not accept top_k; any value will be rejected with a 400 error.
+
   Only sample from the top K options for each subsequent token.
 
   Used to remove "long tail" low probability responses. [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).

 
   Recommended for advanced use cases only.
 
+  minimum: 0
+
 - `top_p: optional number`
 
+  **Deprecated**: Deprecated. Models released after Claude Opus 4.6 do not support setting top_p. A value >= 0.99 will be accepted for backwards compatibility, all other values will be rejected with a 400 error.
+
   Use nucleus sampling.
 
   In nucleus sampling, we compute the cumulative distribution over all the options for each subsequent token in decreasing probability order and cut it off once it reaches a particular probability specified by `top_p`.

 
   Recommended for advanced use cases only.
 
-### Returns
+  maximum: 1, minimum: 0
 
-- `Completion object { id, completion, model, 2 more }`
+## Returns
 
+- `Completion object`
+
   - `id: string`
 
     Unique object identifier.

 
     For Text Completions, this is always `"completion"`.
 
-    - `"completion"`
+    default: completion
 
-### Example
+- `Completion object`
 
-```http
+## Example
+
+```bash
 curl https://api.anthropic.com/v1/complete \
     -H 'Content-Type: application/json' \
     -H 'anthropic-version: 2023-06-01' \

         }'
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {