返回文档首页
文本补全 - API 文档
给模型一段文本开头,让它续写后续内容。适合简单的文本生成任务。
接口说明 这是什么
文本补全 接口接收一段 prompt(提示文本),模型自动续写后续内容。
有什么用:简单的文本续写、关键词扩写、标题生成等。需要多轮对话请用 Chat 对话 接口。
请求信息
| 项目 | 值 |
| 请求方法 | POST |
| 请求路径 | https://103.236.87.35/v1/completions |
| 请求头 | Authorization: Bearer <你的密钥>
Content-Type: application/json |
| 是否需要鉴权 | 必需 |
| 是否计费 | 按 Token 计费 |
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
model | string | 是 | - | 模型名称,如 deepseek-v4-flash |
prompt | string | 是 | - | 提示文本,模型从此续写 |
max_tokens | integer | 否 | 模型默认 | 生成的最大 token 数 |
temperature | number | 否 | 1 | 随机性,0~2 |
top_p | number | 否 | 1 | 核采样 |
stop | string/array | 否 | - | 遇到该字符串即停止生成 |
stream | boolean | 否 | false | 是否流式返回 |
怎么请求 请求示例
curl
curl https://103.236.87.35/v1/completions \
-H "Authorization: Bearer <你的密钥>" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"prompt": "从前有座山,山里有座庙,",
"max_tokens": 100
}'
Python
from openai import OpenAI
client = OpenAI(api_key="<你的密钥>", base_url="https://103.236.87.35/v1")
resp = client.completions.create(
model="deepseek-v4-flash",
prompt="从前有座山,山里有座庙,",
max_tokens=100,
)
print(resp.choices[0].text)
返回示例 成功响应
{
"id": "cmpl-xxx",
"object": "text_completion",
"created": 1788840893,
"model": "deepseek-v4-flash-ga-260731",
"choices": [
{
"text": "庙里有个老和尚在讲故事……",
"index": 0,
"finish_reason": "stop"
}
],
"usage": {"prompt_tokens": 12, "completion_tokens": 30, "total_tokens": 42}
}
返回字段说明
| 字段名 | 类型 | 说明 |
id | string | 本次请求唯一 ID |
choices[].text | string | 模型续写的文本内容 |
choices[].finish_reason | string | 结束原因:stop / length |
usage | object | token 用量(计费依据) |