OpenAI 原生格式（Completions）

这是 OpenAI 传统 Completions API 的原生请求格式，使用 prompt 输入文本并在 choices[].text 中读取结果。新项目通常优先选择 Chat Completions 格式 或 Responses 格式；只有客户端或现有代码明确要求 Completions 接口时才使用本页。

请求

POST /v1/completions
Content-Type: application/json
Authorization: Bearer sk-your-api-key

调用示例

curl -X POST "https://www.walmind.cn/v1/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "your-model-id",
    "prompt": "用一句话解释向量数据库：",
    "max_tokens": 100,
    "stream": false
  }'

Python SDK 示例：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API_KEY"],
    base_url="https://www.walmind.cn/v1",
)

response = client.completions.create(
    model="your-model-id",
    prompt="用一句话解释向量数据库：",
    max_tokens=100,
)
print(response.choices[0].text)

常用参数

参数	类型	说明
model	string	模型列表中的模型 ID，必填
prompt	string 或 array	文本提示词，必填
max_tokens	integer	限制生成的 Token 数量
temperature	number	输出随机性；是否可用取决于模型
stop	string 或 array	让模型停止生成的序列
stream	boolean	是否使用 SSE 流式响应

响应示例

{
  "id": "cmpl-example",
  "object": "text_completion",
  "choices": [
    {
      "index": 0,
      "text": "向量数据库用于存储和检索向量表示。",
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 12, "completion_tokens": 12, "total_tokens": 24}
}

并非所有聊天模型都支持传统文本补全。调用前请从模型列表、模型说明或管理员处确认该格式已启用；如果返回 unsupported 或 model not found，请改用该模型支持的 Chat Completions 或 Responses 格式。