完形填空
更新时间:2022-05-24
接口说明
完形填空:完形填空接口基于文心ERNIE 3.0 Zeus大模型,用户按规定的prompt模板输入上文,接口自动生成不同长度的下文。
温馨提示:
每个账户每日免费请求ERNIE 3.0 Zeus API服务的上限为200条输入,免费请求额度共2000条输入。如果您有更多请求需求,请跟我们联系:wenxin-younger@baidu.com
接口要求
内容 | 说明 |
---|---|
传输方式 | https (为提高安全性,强烈推荐https) |
请求地址 | https://wenxin.baidu.com/younger/portal/api/rest/1.0/ernie/3.0/zeus |
字符编码 | UTF-8 |
响应格式 | 统一采用JSON格式 |
开发语言 | 任意,只要可以向服务发起HTTP请求的均可 |
适用范围 | 任意操作系统,但因不支持跨域不适用于浏览器,请在后端调用接口 |
请求行 | POST |
请求QPS限制 | 2 |
平均响应时间 | 生成512需要16.3s,生成256需要8.1s,生成128需要4.1s |
接口调用流程
- 将请求参数放在Http Request Body中,以POST表单的形式提交,详见下方 请求参数 。
- 向服务器端发送Http请求后,接收服务器端的返回结果。
请求参数
- 在调用业务接口时,配置以下参数。
- header 信息
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
- 参数
参数名 | 类型 | 是否必传 | 描述 |
---|---|---|---|
access_token | string | 是 | 参考 API鉴权 |
text | string | 是 | 输入内容,长度不超过1000 |
seq_len | int | 是 | 输出内容最大长度,长度不超过1000 |
task_prompt | string | 否 | 任务类型的模板 |
dataset_prompt | string | 否 | 数据集类型的模板 |
topk | int | 否 | topk采样,取值>1,默认为10。每步的生成的结果从topk的概率值分布中采样。其中topk=1表示贪婪采样,每次生成结果固定。 |
temperature | float | 否 | 温度系数,取值>0.0,默认为1.0。更大的温度系数表示模型生成的多样性更强。 |
penalty_score | float | 否 | 重复惩罚。取值>=1.0,默认为1.0。通过对已生成的token增加惩罚,减少重复生成的现象。值越大表示惩罚越大。 |
penalty_text | string | 否 | 惩罚文本,默认为空。模型无法生成该字符串中的token。通过设置该值,可以减少某些冗余与异常字符的生成。 |
choice_text | string | 否 | 候选文本,默认为空。模型只能生成该字符串中的token的组合。通过设置该值,可以对某些抽取式任务进行定向调优。 |
stop_token | string | 否 | 提前结束符,默认为空。预测结果解析时使用的结束字符,碰到对应字符则直接截断并返回。可以通过设置该值,过滤掉few-shot等场景下模型重复的cases。 |
is_unidirectional | int | 否 | 单双向控制开关,取值0或者1,默认为0。0表示模型为双向生成,1表示模型为单向生成。建议续写与few-shot等通用场景建议采用单向生成方式,而完形填空等任务相关场景建议采用双向生成方式。 |
min_dec_len | int | 否 | 最小生成长度,取值>=1,默认为1。开启后会屏蔽掉END结束符号,让模型生成至指定的最小长度。 |
min_dec_penalty_text | string | 否 | 默认为空,与最小生成长度搭配使用,可以在min_dec_len步前不让模型生成该字符串中的tokens。 |
请求参数样例:
'access_token': '24.9991a77ac60c6e969e176b776f74b09e.86400000.1653006451543.499f8f33b6821ebbf9ba1fbea525d6ae-6',
'text': '人生要学会选择。在心存忧惧的时候,你是自暴自弃、一蹶不振,还是[MASK]、愈挫愈勇?',
'seq_len': 128,
'task_prompt': '',
'dataset_prompt': '',
'topk': 1,
'stop_token': ''
返回参数
参数名 | 类型 | 描述 |
---|---|---|
code | int | 错误码 |
msg | string | 错误信息 |
data | object | 结果对象 |
返回参数样例:
{
"code": 0,
"msg": "success",
"data":
{
"result": "积极进取"
}
}
错误码
错误码 | 错误描述 |
---|---|
4001 | 请求参数格式错误,不是标准的JSON格式 |
4002 | 请求参数格式错误,请检查必传参数是否齐全,参数类型等 |
4003 | text长度超过模型要求的最大值 |
4004 | API服务内部错误,可能引起原因有请求超时、模型推理错误等 |
代码示例
import requests
url = "https://wenxin.baidu.com/younger/portal/api/rest/1.0/ernie/3.0/zeus"
payload={
'text': '人生要学会选择。在心存忧惧的时候,你是自暴自弃、一蹶不振,还是[MASK]、愈挫愈勇?',
'seq_len': 128,
'task_prompt': '',
'dataset_prompt': '',
'access_token': '24.9991a77ac60c6e969e176b776f74b09e.86400000.1653006451543.499f8f33b6821ebbf9ba1fbea525d6ae-6',
'topk': 1,
'stop_token': ''
}
response = requests.request("POST", url, data=payload)
print(response.text)
curl -i -k 'https://wenxin.baidu.com/younger/portal/api/rest/1.0/ernie/3.0/zeus?access_token=24.9991a77ac60c6e969e176b776f74b09e.86400000.1653006451543.499f8f33b6821ebbf9ba1fbea525d6ae-6' --data-urlencode 'text=人生要学会选择。在心存忧惧的时候,你是自暴自弃、一蹶不振,还是[MASK]、愈挫愈勇?' -d 'seq_len=128&is_unidirectional=0&topk=1'
package main
import (
"fmt"
"bytes"
"mime/multipart"
"net/http"
"io/ioutil"
)
func main() {
url := "https://wenxin.baidu.com/younger/portal/api/rest/1.0/ernie/3.0/zeus"
method := "POST"
payload := &bytes.Buffer{}
writer := multipart.NewWriter(payload)
_ = writer.WriteField("text", "人生要学会选择。在心存忧惧的时候,你是自暴自弃、一蹶不振,还是[MASK]、愈挫愈勇?")
_ = writer.WriteField("seq_len", "128")
_ = writer.WriteField("dataset_prompt", "")
_ = writer.WriteField("task_prompt", "")
_ = writer.WriteField("topk", "1")
_ = writer.WriteField("stop_token", "")
_ = writer.WriteField("access_token", "24.9991a77ac60c6e969e176b776f74b09e.86400000.1653006451543.499f8f33b6821ebbf9ba1fbea525d6ae-6")
err := writer.Close()
if err != nil {
fmt.Println(err)
return
}
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Set("Content-Type", writer.FormDataContentType())
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
```ni