请输入
菜单

文本补全(OpenAI)

根据 prompt 续写文本。需要聊天对话时请选择 Chat Completions,而不是把 messages 直接传给此接口。

请求

项目 说明
方法 POST
路径 /v1/completions
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Body string 是 支持传统 Completions 的模型
prompt Body string / string[] 是 输入提示词
max_tokens Body integer 否 正整数,输出 token 上限
temperature Body number 否 采样温度,取值以模型为准
top_p Body number 否 核采样参数
stream Body boolean 否 是否启用 SSE
stop Body string / string[] 否 停止序列
n Body integer 否 生成候选数,默认使用 1;以模型支持范围为准
echo Body boolean 否 是否回显输入,需模型支持
suffix Body string 否 补全后的后缀,需模型支持

调用示例

curl -X POST 'https://ailink.nativex.com/v1/completions' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "MODEL_ID",
  "prompt": "请续写:清晨的第一缕阳光",
  "max_tokens": 128
}'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "id": "cmpl_example",
  "object": "text_completion",
  "choices": [
    {
      "text": "照亮了窗边的书桌。",
      "index": 0,
      "finish_reason": "stop"
    }
  ]
}
字段或结果 说明
choices[].text 补全文本
choices[].finish_reason 结束原因

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28