DocsDeployment APICompletions

Completions

Legacy text completions endpoint. POST /api/v1/completions.

Navigation

Completions (Legacy)

POST /api/v1/completions

Creates a completion for the given prompt. This is the legacy text completions endpoint — for new projects, use Chat Completions instead.

Request Body

ParameterTypeRequiredDescription
modelstringYesModel ID
promptstringYesThe text prompt to complete
max_tokensintegerNoMaximum tokens to generate
streambooleanNoWhether to stream the response
temperaturenumberNoSampling temperature (0-2)

Response

{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1714000000,
  "model": "llama-4-scout",
  "choices": [
    {
      "text": "\n\nThe answer is 42.",
      "index": 0,
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 10,
    "total_tokens": 15
  }
}