> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Text completions — POST /v1/completions

> POST /v1/completions — legacy text completion endpoint. Accepts model, prompt, max_tokens, temperature, and stream. Returns a completion object or SSE stream.

The text completions endpoint is a legacy OpenAI-compatible endpoint that generates a continuation of a raw text prompt rather than a structured message history. It is routed through the same provider dispatch pipeline as [chat completions](/reference/chat-completions), so the same attestation headers and streaming format apply.

For most use cases, prefer [POST /v1/chat/completions](/reference/chat-completions), which is the actively developed endpoint with full tool-call and response-format support.

## Authentication

All inference endpoints require a Bearer token:

```
Authorization: Bearer eigeninference-...
```

## Request

<ParamField body="model" type="string" required>
  The model ID to use. See [Models](/reference/models) for the list of available IDs.
</ParamField>

<ParamField body="prompt" type="string" required>
  The input text to complete.
</ParamField>

<ParamField body="max_tokens" type="integer">
  Maximum number of tokens to generate. Defaults to 8192 if not set.
</ParamField>

<ParamField body="temperature" type="number">
  Sampling temperature between 0 and 2.
</ParamField>

<ParamField body="stream" type="boolean" default="false">
  When `true`, returns the response as SSE chunks ending with `data: [DONE]`.
</ParamField>

## Example

```bash cURL theme={null}
curl https://api.darkbloom.dev/v1/completions \
  -H "Authorization: Bearer eigeninference-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.5-27b-claude-opus-8bit",
    "prompt": "The capital of France is",
    "max_tokens": 16
  }'
```