保姆级教程 文心一言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 的调用流程如下图所示。

1. 创建一个千帆应用。根据实际需求创建千帆应用，创建成功后，获取AppID、API Key、Secret Key 等信息。

2. API 授权。对应用的 AppID 进行授权。

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 Key、Secret Key，获取access_token。参考以下获取access_token，更多详情方法请参考获取access_token。

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

步骤四. 调用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密钥，确保身份验证和权限控制的可靠性。