文本补全

基于一段提示词(prompt)直接生成续写文本,是 Chat Completions 之前的经典补全接口,兼容 OpenAI Completions 协议。

基本信息

方法POST 端点https://koprouter.kopglobal.com/v1/completions 鉴权Authorization: Bearer sk-...

请求参数

参数 类型 必填 说明
model string 是 要调用的模型 ID
prompt string/array 是 提示词,可为字符串或 token 数组
max_tokens number 否 生成的最大 token 数
temperature number 否 采样温度,范围 0~2
top_p number 否 核采样概率
n number 否 候选数量
stream boolean 否 是否流式返回
stop string/array 否 停止符

请求示例

curl https://koprouter.kopglobal.com/v1/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Once upon a time",
    "max_tokens": 64
  }'

响应示例

{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1720000000,
  "model": "MODEL_ID",
  "choices": [
    {
      "text": " there was a small village.",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 4,
    "completion_tokens": 6,
    "total_tokens": 10
  }
}
多数对话场景建议使用 [对话补全](/docs/zh-Hans/chat-completions),本端点更适合纯文本续写类任务。