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

# 文本补全

> 基于给定提示创建文本补全。这是传统的 Completions 接口，适用于需要模型续写或补全文本的场景。

## 请求头

**Authorization** `string` *required*

使用 Bearer Token 认证。格式：`Authorization: Bearer sk-xxxxxx`

## 请求体

格式：`application/json`

**model** `string` *required*

模型 ID

**prompt** `string | string[]` *required*

提示文本，可为字符串或字符串数组

**max\_tokens** `integer`

最大生成 Token 数

**temperature** `number`

采样温度

**top\_p** `number`

核采样参数

**n** `integer`

生成数量

**stream** `boolean`

是否流式响应

**stop** `string | string[]`

停止序列

**suffix** `string`

插入后缀文本

**echo** `boolean`

是否在输出中回显提示文本

## 响应

### 200 成功创建响应

格式：`application/json`

> **TypeScript 类型定义**
>
> ```ts theme={"dark"}
> interface CompletionResponse {
>   id?: string;
>   object?: string;
>   created?: number;
>   model?: string;
>   choices?: {
>     text?: string;
>     index?: number;
>     finish_reason?: string;
>   }[];
>   usage?: {
>     prompt_tokens?: number;
>     completion_tokens?: number;
>     total_tokens?: number;
>     prompt_tokens_details?: {
>       cached_tokens?: number;
>       text_tokens?: number;
>       audio_tokens?: number;
>       image_tokens?: number;
>     };
>     completion_tokens_details?: {
>       text_tokens?: number;
>       audio_tokens?: number;
>       reasoning_tokens?: number;
>     };
>   };
> }
> ```

**id** `string`

补全 ID

**object** `string`

对象类型，值为 `text_completion`

**created** `integer`

创建时间戳

**model** `string`

模型 ID

**choices** `object[]`

生成结果列表

**属性**

**text** `string`

生成的文本

**index** `integer`

结果索引

**finish\_reason** `string`

结束原因

**usage** `object`

Token 用量信息

**属性**

**prompt\_tokens** `integer`

提示词 Token 数

**completion\_tokens** `integer`

补全 Token 数

**total\_tokens** `integer`

总 Token 数

**prompt\_tokens\_details** `object`

提示 Token 明细

**属性**

**cached\_tokens** `integer`

缓存 Token 数

**text\_tokens** `integer`

文本 Token 数

**audio\_tokens** `integer`

音频 Token 数

**image\_tokens** `integer`

图像 Token 数

**completion\_tokens\_details** `object`

补全 Token 明细

**属性**

**text\_tokens** `integer`

文本 Token 数

**audio\_tokens** `integer`

音频 Token 数

**reasoning\_tokens** `integer`

推理 Token 数

```bash cURL theme={"dark"}
curl -X POST "https://t.ato2.nodesms.com/v1/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "string",
    "prompt": "string"
  }'
```

```python Python theme={"dark"}
import openai

client = openai.OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://t.ato2.nodesms.com/v1"
)

response = client.completions.create(
    model="string",
    prompt="string"
)
print(response.choices[0].text)
```

```json 200 theme={"dark"}
{
  "id": "string",
  "object": "text_completion",
  "created": 0,
  "model": "string",
  "choices": [
    {
      "text": "string",
      "index": 0,
      "finish_reason": "string"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.