文本补全（Completions）

传统的文本补全接口，给定 prompt 续写文本。新项目建议优先使用聊天接口，本接口主要用于兼容旧有的补全类模型与客户端。

创建文本补全

POST /v1/completions

请求参数

参数	类型	必填	说明
model	string	是	模型标识
prompt	string | array	是	待续写的提示文本
max_tokens	integer	否	生成的最大 Token 数
temperature	number	否	采样温度，默认 1
top_p	number	否	核采样，默认 1
stream	boolean	否	是否流式返回，默认 false
stop	string | array	否	停止词

请求示例

curl https://ai.youqi.tech/v1/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo-instruct",
    "prompt": "写一句关于大海的诗：",
    "max_tokens": 32
  }'

响应示例

{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1715367049,
  "model": "gpt-3.5-turbo-instruct",
  "choices": [
    {
      "index": 0,
      "text": "海的尽头是天，天的尽头是心之所向。",
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 20,
    "total_tokens": 32
  }
}

注意

文本补全为旧版接口，能力弱于聊天接口，且并非所有模型都支持。除非有明确的兼容需求，建议使用聊天（Chat Completions）。