续写
调用本接口，发起一次续写请求。
支持模型列表
支持模型列表请查看FIM补全-支持模型列表。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
续写的后缀信息，FIM补全场景下需要提供。
是否以流式接口的形式返回数据，说明：
· true：是，按SSE协议逐块返回内容，以一条data: [DONE]消息结束
· false：否，默认false
流式响应的选项，当字段stream为true时，该字段生效
显示子属性
隐藏子属性
流式响应是否输出usage，说明：
· true：是，设置为true时，在最后一个chunk会输出一个字段，这个chunk上的usage字段显示整个请求的token统计信息
· false：否，流式响应默认不输出usage
说明：
（1）较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定
（2）该参数支持模型及取值范围等，请参考千帆ModelBuilder-模型默认参数说明
生成停止标识，当模型生成结果以stop中某个元素结尾时，停止文本生成。说明：
（1）每个元素长度不超过20字符
（2）最多4个元素
显示子属性
隐藏子属性
表示最终用户的唯一标识符
POST /v2/completions HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "qwen3-coder-480b-a35b-instruct",
"prompt" : "def fib(a):",
"suffix" :" return fib(a-1) + fib(a-2)"
}示例代码
curl --location 'https://qianfan.baidubce.com/v2/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxx' \
--data '{
"model": "qwen3-coder-480b-a35b-instruct",
"prompt" : "def fib(a):",
"suffix" :" return fib(a-1) + fib(a-2)",
"stream": true,
"stream_options": {
"include_usage": true
}
}'
返回响应
本次请求的唯一标识，可用于排查问题
对象类型，始终为“text_completion”
时间戳
本次请求使用的大模型ID
多选一，只需要符合下列任意一组子节点
显示子属性
隐藏子属性
stream=false时，返回该内容，返回类型为choices
显示子属性
隐藏子属性
choice列表中的序号
本次请求生成的内容
输出内容标识，说明：
· stop：模型自然停止或命中提供的停止序列
· length：达到了最大的token数
· content_filter：输出内容被截断、兜底、替换为**等
安全细分类型，说明：
当stream=false，flag值含义如下：
· 0或不返回：安全
· 1：低危不安全场景，可以继续对话
· 2：禁聊：不允许继续对话，但是可以展示内容
· 3：禁止上屏：不允许继续对话且不能上屏展示
· 4：撤屏
当flag 不为 0 时，该字段会告知第几轮对话有敏感信息；如果是当前问题，ban_round = -1
stream=true时，返回该内容，各子段的响应参数为 data: {响应参数}
显示子属性
隐藏子属性
choice列表中的序号
本次请求生成的内容
输出内容标识，说明：
· stop：模型自然停止或命中提供的停止序列
· length：达到了最大的token数
· content_filter：输出内容被截断、兜底、替换为**等
安全细分类型，说明：
当stream=false，flag值含义如下：
· 0或不返回：安全
· 1：低危不安全场景，可以继续对话
· 2：禁聊：不允许继续对话，但是可以展示内容
· 3：禁止上屏：不允许继续对话且不能上屏展示
· 4：撤屏
当flag 不为 0 时，该字段会告知第几轮对话有敏感信息；如果是当前问题，ban_round = -1
token统计信息，说明：
（1）同步请求默认返回
（2）流式请求默认不返回，当开启stream_options.include_usage=true时，会在最后一个chunk返回实际内容，其他chunk返回null
显示子属性
隐藏子属性
问题tokens数（包含历史QA）
回答tokens数
总tokens数
{
"id": "as-a3qbse8gzc",
"object": "text_completion",
"created": 1756179207,
"model": "qwen3-coder-480b-a35b-instruct",
"choices": [{
"text": "\n if a == 0 or a == 1:\n return 1\n\n",
"index": 0,
"finish_reason": "stop",
"flag": 0
}],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 18,
"total_tokens": 38
}
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。