文本补全

传统文本补全接口；并非所有对话模型都支持此格式。

POST/v1/completions

OpenAI 兼容

Headers请求头

左右滑动查看完整参数表

请求头
参数名	类型	必填	说明	默认值 / 示例
`Authorization`	string	必填	平台 API Key，使用 Bearer 认证。	示例 `Bearer YOUR_API_KEY`
`Content-Type`	string	必填	请求体编码格式。	示例 `application/json`

Request Body请求体

application/json

左右滑动查看完整参数表

请求体
参数名	类型	必填	说明	默认值 / 示例
`model`	string	必填	模型 ID；请替换为账户可用且支持当前接口的模型。	示例 `MODEL_ID`
`prompt`	string \| array<string> \| array<integer> \| array<array<integer>>	必填	需要补全的文本，文本列表，或模型支持的 Token ID 列表。	示例 `请用一句话解释什么是 API。`
`max_tokens`	integer	可选	最大生成 Token 数。	—
`temperature`	number	可选	采样温度；通常与 top_p 二选一调整。	—
`top_p`	number	可选	核采样阈值。	—
`n`	integer	可选	生成的候选补全数量。	—
`stream`	boolean	可选	是否以 SSE 流返回增量输出。	默认值 `false`
`stop`	string \| array<string>	可选	停止生成的字符串或字符串列表。	—
`suffix`	string	可选	插入式补全的后缀；需模型支持。	—
`echo`	boolean	可选	旧版补全格式中的提示词回显选项；使用前确认所选模型支持。	—

使用说明

传统补全格式需要兼容该接口的模型，不能直接假定任意对话模型都可使用。
stream=true 时返回 SSE；下方为非流式响应结构样例。

调用示例

curl --fail-with-body \
  --max-time 120 \
  --request POST \
  https://ai.kedang.net/v1/completions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "MODEL_ID",
  "prompt": "请用一句话解释什么是 API。",
  "max_tokens": 128
}'

# pip install requests
import requests

url = 'https://ai.kedang.net/v1/completions'
headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}
payload = {'model': 'MODEL_ID', 'prompt': '请用一句话解释什么是 API。', 'max_tokens': 128}

response = requests.request(
    'POST', url, headers=headers, timeout=120, json=payload
)
response.raise_for_status()
print(response.json())

// Node.js 18+ · 保存为 example.mjs 后运行

const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
const payload = {
  "model": "MODEL_ID",
  "prompt": "请用一句话解释什么是 API。",
  "max_tokens": 128
};

const response = await fetch("https://ai.kedang.net/v1/completions", {
  method: "POST",
  headers,
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify(payload),
});
if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`);
}
console.log(await response.json());

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"strings"
	"time")

func main() {
	payload := strings.NewReader("{\n  \"model\": \"MODEL_ID\",\n  \"prompt\": \"请用一句话解释什么是 API。\",\n  \"max_tokens\": 128\n}")
	req, err := http.NewRequest("POST", "https://ai.kedang.net/v1/completions", payload)
	if err != nil { log.Fatal(err) }
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{Timeout: 120 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()
	data, err := io.ReadAll(resp.Body)
	if err != nil { log.Fatal(err) }
	if resp.StatusCode >= 400 { log.Fatalf("%s: %s", resp.Status, data) }
	fmt.Println(string(data))
}

响应示例

200

{
  "id": "cmpl_example",
  "object": "text_completion",
  "created": 0,
  "model": "MODEL_ID",
  "choices": [
    {
      "text": "API 是软件之间交换数据和调用功能的接口。",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}