根据 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。