文心一言API接入指南
一、了解文心一言
文心一言是百度打造出来的人工智能大语言模型，具备跨模态、跨语言的深度语义理解与生成能力，文心一言有五大能力，文学创作、商业文案创作、数理逻辑推算、中文理解、多模态生成，其在搜索问答、内容创作生成、智能办公等众多领域都有更广阔的想象空间。
文心一言企业服务由千帆大模型平台提供，包括推理服务及大模型微调等一系列开发和应用工具链。文心一言大模型现已升级至4.0，企业客户可通过百度智能云千帆大模型平台申请接入。
二、接入文心一言
API 列表
百度智能云千帆平台提供了丰富的API，保留对话Chat、续写Completions、向量Embeddings、插件应用、Prompt工程、大模型训练、管理及服务等API能力，详情请查看API列表。
大模型相关
- 对话Chat：支持创建chat，用于发起一次对话。
- 续写Completions：支持创建completion，用于发起一次续写请求，不支持多轮会话等。
- 向量Embeddings：支持Embeddings，用于根据输入内容生成对应的向量表示。
- 自定义模型导入：支持HuggingFace Transformer架构的自定义模型导入，提供自定义模型导入相关API能力。
- 图像Images：提供图像相关API能力。
- 插件应用：提供域内知识搜索增强插件API相关能力。
Prompt工程：提供模版相关API能力。
大模型训练：提供创建训练任务、任务运行、停止任务运行及获取任务运行详情等API能力。
大模型管理：提供获取模型、模型版本详情及将训练任务发布为模型等API能力。
大模型服务：提供创建服务、获取服务详情等API能力。
API 调用流程简介
API 的调用流程如下图所示。
创建一个千帆应用。根据实际需求创建千帆应用，创建成功后，获取AppID、API Key、Secret Key 等信息。
API 授权。对应用的 AppID 进行授权。
获取接口访问凭证 access_token 。根据第1步获取的 API Key 和 Secret Key ，调用获取access_token接口获取 access_token ，通过 access_token 鉴权调用者身份。
调用API接口。例如调用ERNIE-Bot相关接口，详见API列表。
API 调用流程
步骤一. 创建千帆应用
（1）登录百度智能云千帆控制台。
请您注册并登录百度智能云千帆控制台 。
注意：为保障服务稳定运行，账户最好不处于欠费状态。
（2）创建千帆应用
进入控制台创建应用 。
（3）创建应用后，获取AppID、API Key、Secret Key。
步骤二. 服务授权
应用创建后，选择对应授权的公有云服务。
步骤三. 获取访问凭证
根据步骤一获取的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列表。
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。
具体操作可查看视频：<a href="https://bce-doc-on.bj.bcebos.com/%20wenxinworkshop/千帆-调用服务.mp4" target="_blank">快速上手API调用</a>。
三、重点词汇或短语
在接入文心一言的过程中，以下几个重点词汇或短语需要特别注意：
1.API接口：指文心一言提供的服务接口，用户可以通过调用接口，实现对文本数据的分析和处理。
2.情感分析：指通过自然语言处理技术，对文本的情感倾向进行分析和判断。情感分析是文心一言的重要功能之一，能够帮助用户了解文本的情感色彩和情感变化。
3.关键词提取：指从文本中提取出重要的关键词和短语。关键词提取是文心一言的另一个重要功能，能够帮助用户快速了解文本的核心内容和主题。
4.语言分类：指对文本进行分类和归类。文心一言可以根据文本的内容和主题，对文本进行分类和归类，帮助用户更好地了解文本的属性和特征。
5.API密钥：指用于身份验证和权限控制的重要凭证，必须妥善保管。在调用文心一言的API接口时，必须提供正确的API密钥才能够正常使用文心一言的服务。
总之，接入文心一言是一项非常重要的任务，能够帮助用户更好地了解和分析文本数据。同时，也需要妥善保管API密钥，确保身份验证和权限控制的可靠性。