POST/v1/completions

旧版 Completions：文本续写

为存量 instruct 应用保留 prompt 形式的文本续写入口。

API Key application/json

功能与适用场景

接收一个 prompt 并返回续写。新应用优先使用 Chat / Responses，本页不是现代多轮消息接口。

支持模型与组合

示例 gpt-3.5-turbo-instruct，仅在账号仍开放时使用。GPT‑5/6 不能直接替换它。

第一步：设置鉴权

使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY。替换占位符，保留 Bearer 后的空格。无需厂商 API Key。

第二步：调用模型

POST https://top.qingyuntop.ai/v1/completions

请求为 application/json。

Legacy Completions

调用与返回说明

旧式文本补全接口。仅在目标模型明确要求 prompt 接口时使用；不要把它当作 Chat 或 Responses 的替代协议。

请求时注意

先确认模型明确支持 /v1/completions。多数新模型应改用 /v1/responses 或 /v1/chat/completions。
prompt 是纯文本补全输入，不能直接套用 messages 或 input 项目数组。
max_tokens、best_of、suffix 等字段的兼容性取决于旧模型，不要跨协议复用。

返回时注意

读取 choices[].text，并检查 finish_reason；此结构与 Chat Completions 的 message.content 和 Responses 的 output 不同。

Request

请求

/v1/completions

Body

必填

Bodyobject

modelstring必填

必填，顶层。仅兼容旧 Completion 模型，例如 gpt-3.5-turbo-instruct；GPT-5/6 等用 Chat 或 Responses。

promptstring / array必填

必填，顶层，待续写文本；不是 messages 数组。；分支：string / array<string>

best_ofinteger

默认为1 在服务器端生成best_of个补全,并返回“最佳”补全(每个令牌的日志概率最高的那个)。无法流式传输结果。与n一起使用时,best_of控制候选补全的数量,n指定要返回的数量 – best_of必须大于n。注意:因为这个参数会生成许多补全,所以它可以快速消耗您的令牌配额。请谨慎使用,并确保您对max_tokens和stop有合理的设置。

echoboolean

选填字段；是否可用取决于当前模型和协议。

frequency_penaltynumber

默认为0 -2.0和2.0之间的数字。正值根据文本目前的现有频率处罚新令牌,降低模型逐字重复相同行的可能性。

logit_biasobject

默认为null 修改完成中指定令牌出现的可能性。接受一个JSON对象,该对象将令牌(由GPT令牌化器中的令牌ID指定)映射到关联偏差值,-100到100。您可以使用这个令牌化器工具(适用于GPT-2和GPT-3)将文本转换为令牌ID。从数学上讲,偏差在对模型进行采样之前添加到生成的logit中。确切效果因模型而异,但-1至1之间的值应降低或提高选择的可能性;像-100或100这样的值应导致相关令牌的禁用或专属选择。例如,您可以传递{"50256": -100}来防止生成<|endoftext|>令牌。

logprobsnull

默认为null 包括logprobs个最可能令牌的日志概率,以及所选令牌。例如,如果logprobs为5,API将返回5个最有可能令牌的列表。 API总会返回采样令牌的logprob,因此响应中最多可能有logprobs+1个元素。 logprobs的最大值是5。

max_tokensinteger

选填，正整数，示例64。表示续写长度上限。

ninteger

选填字段；是否可用取决于当前模型和协议。

presence_penaltynumber

默认为0 -2.0和2.0之间的数字。正值根据它们是否出现在目前的文本中来惩罚新令牌,增加模型讨论新话题的可能性。有关频率和存在惩罚的更多信息,请参阅。

seedinteger

如果指定,我们的系统将尽最大努力确定性地进行采样,以便使用相同的种子和参数的重复请求应返回相同的结果。不保证确定性,您应该参考system_fingerprint响应参数来监视后端的更改。

stopstring | array<string>

选填字段；是否可用取决于当前模型和协议。；分支：string / array<string>

streamboolean

选填字段；是否可用取决于当前模型和协议。

suffixstring

选填字段；是否可用取决于当前模型和协议。

temperaturenumber

选填字段；是否可用取决于当前模型和协议。

userstring必填

top_pnumber

选填字段；是否可用取决于当前模型和协议。

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

set -euo pipefail
python3 - <<'PY'
import base64
import json
from pathlib import Path

payload = json.loads(r'''{
  "model": "gpt-3.5-turbo-instruct",
  "prompt": "请续写：今天我学会了",
  "max_tokens": 64
}''')
encoded = json.dumps(payload, ensure_ascii=False).encode("utf-8")
Path("request.json").write_bytes(encoded)
PY
curl --fail-with-body --connect-timeout 30 --max-time 600 "https://top.qingyuntop.ai/v1/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  --output response.json

Response

返回响应 `200`

HTTP 响应

响应 200object

idstring必填

objectstring必填

createdinteger必填

modelstring必填

system_fingerprintstring必填

choicesarray必填

旧 Completion 从 choices[].text 取续写结果，不是 message.content；检查 finish_reason。

元素object

数组元素。

textstring

indexinteger

logprobsnull

finish_reasonstring

usageobject必填

prompt_tokensinteger必填

completion_tokensinteger必填

total_tokensinteger必填

响应示例json

{
  "id": "cmpl_example",
  "object": "text_completion",
  "model": "MODEL_ID_FROM_V1_MODELS",
  "choices": [
    {
      "index": 0,
      "text": "补全结果",
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 6,
    "total_tokens": 14
  }
}

Legacy Completions

调用与返回说明

旧式文本补全接口。仅在目标模型明确要求 prompt 接口时使用；不要把它当作 Chat 或 Responses 的替代协议。

请求时注意

先确认模型明确支持 /v1/completions。多数新模型应改用 /v1/responses 或 /v1/chat/completions。
prompt 是纯文本补全输入，不能直接套用 messages 或 input 项目数组。
max_tokens、best_of、suffix 等字段的兼容性取决于旧模型，不要跨协议复用。

返回时注意

读取 choices[].text，并检查 finish_reason；此结构与 Chat Completions 的 message.content 和 Responses 的 output 不同。

常见错误与参考

给此接口发送 messages、图片内容块或新版 Chat 工具定义会导致结构不匹配。需要升级时改请求体和响应读取逻辑。

401：检查本站 API Key 和 Bearer 格式；403：确认此 Key 可用该模型；429：遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误，避免盲目重发；其他通用排查见聊天接入总览。

OpenAI 公共 API 规范。旧版响应对象。

旧版 Completions：文本续写

功能与适用场景

支持模型与组合

第一步：设置鉴权

第二步：调用模型

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

常见错误与参考

返回响应 `200`