文心千帆：百度文心一言的接口对接实践

文心一言（ERNIE Bot）是百度基于文心大模型技术推出的生成式对话产品，于2023年3月16日14时在北京总部召开产品发布会。2023年3月16日14时，百度“官宣”了对标ChatGPT的产品——“文心一言”（ERNIE Bot），可以执行广泛的任务，包括语言理解、语言生成以及根据文本生成图像等。

文心一言具有以下新功能：

1. 文学创作：文心一言可以根据用户提供的主题、情节或关键词等信息，自动生成小说、散文、诗歌等不同类型和风格的原创作品。
2. 商业文案创作：文心一言可以根据用户提供的产品或服务信息，自动生成适合不同场景和目标客户群体的广告语、口号、标语等吸引眼球并促进销售转化的内容。
3. 智能问答：文心一言可以回答各种问题，无论是关于历史、科学、文化还是日常生活的问题，它都能给出准确的答案。
4. 文本生成：文心一言可以生成各种类型的文本，包括小说、诗歌、新闻、电子邮件等。
5. 智能推荐：文心一言可以根据你的兴趣和喜好，推荐相关的书籍、电影、音乐等。
6. 情感分析：文心一言可以分析文本的情感倾向，帮助你了解某个人或某个群体对某个话题或事件的情感态度。
7. 数理逻辑推算：文心一言具有数理逻辑推算的能力，能够进行数学问题的解答和推理。
8. 中文理解：文心一言具备优秀的中文理解能力，能够根据用户提供的中文语句或段落，自动生成相关的概括、摘要、扩展、改写等内容。
9. 多模态生成：文心一言可以根据用户提供或指定的文字、图片、音频或视频等信息，自动生成与之相关或匹配的多种媒体形式。

对接文心一言

API 调用流程简介

API 的调用流程如下图所示。

1. 创建千帆应用。根据实际需求创建千帆应用，创建成功后，获取AppID、API Key、Secret Key 等信息。如果已有千帆应用，可以查看已有应用的API Key、Secret Key 等信息。
2. API 授权。应用创建成功后，千帆平台默认为应用开通所有API调用权限，无需申请授权。
3. 获取接口访问凭证 access_token。根据第1步获取的 API Key 和 Secret Key ，调用获取access_token接口获取 access_token ，通过 access_token 鉴权调用者身份。
4. 调用API接口。例如调用ERNIE-Bot相关接口，详见API列表。

API 调用流程

步骤一. 创建千帆应用

（1）登录百度智能云千帆控制台。

请您注册并登录百度智能云千帆控制台 。

注意：为保障服务稳定运行，账户最好不处于欠费状态。

（2）创建千帆应用

进入控制台创建应用 。如果已有应用，此步骤可跳过。

（3）创建应用后，获取AppID、API Key、Secret Key。

步骤二. API授权

应用创建成功后，千帆平台默认为应用开通所有API调用权限，无需申请授权。

注意：针对付费服务，如果用户在使用过程中，操作了终止付费，则无法调用对应的API。如需重新开通，请在千帆大模型平台-在线服务页面，点击开通付费。

步骤三. 获取访问凭证

根据步骤一获取的API Key、Secret Key，获取access_token。参考以下获取access_token，更多详情方法请参考获取access_token。

注意：access_token默认有效期30天，生产环境注意及时刷新。

```bash label=bash
# 填充API Key与Secret Key
curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=【API Key】&client_secret=【Secret Key】'
```
```Python label=Python  
# 填充API Key与Secret Key
import requests
import json
def main():
    url = "https://aip.baidubce.com/oauth/2.0/token?client_id=【API Key】&client_secret=【Secret Key】&grant_type=client_credentials"
    payload = json.dumps("")
    headers = {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    }
    response = requests.request("POST", url, headers=headers, data=payload)
    return response.json().get("access_token")
if __name__ == '__main__':
    access_token = main()
    print(access_token)
```

步骤四. 调用API接口

调用千帆提供的相关接口，如ERNIE-Bot等，详见API列表。