文心一言API接入指南
一、了解文心一言
文心一言是百度打造出來的人工智能大語(yǔ)言模型，具備跨模態(tài)、跨語(yǔ)言的深度語(yǔ)義理解與生成能力，文心一言有五大能力，文學(xué)創(chuàng)作、商業(yè)文案創(chuàng)作、數(shù)理邏輯推算、中文理解、多模態(tài)生成，其在搜索問答、內(nèi)容創(chuàng)作生成、智能辦公等眾多領(lǐng)域都有更廣闊的想象空間。
文心一言企業(yè)服務(wù)由千帆大模型平臺(tái)提供，包括推理服務(wù)及大模型微調(diào)等一系列開發(fā)和應(yīng)用工具鏈。文心一言大模型現(xiàn)已升級(jí)至4.0，企業(yè)客戶可通過百度智能云千帆大模型平臺(tái)申請(qǐng)接入。
二、接入文心一言
API 列表
百度智能云千帆平臺(tái)提供了豐富的API，保留對(duì)話Chat、續(xù)寫Completions、向量Embeddings、插件應(yīng)用、Prompt工程、大模型訓(xùn)練、管理及服務(wù)等API能力，詳情請(qǐng)查看API列表。
大模型相關(guān)
- 對(duì)話Chat：支持創(chuàng)建chat，用于發(fā)起一次對(duì)話。
- 續(xù)寫Completions：支持創(chuàng)建completion，用于發(fā)起一次續(xù)寫請(qǐng)求，不支持多輪會(huì)話等。
- 向量Embeddings：支持Embeddings，用于根據(jù)輸入內(nèi)容生成對(duì)應(yīng)的向量表示。
- 自定義模型導(dǎo)入：支持HuggingFace Transformer架構(gòu)的自定義模型導(dǎo)入，提供自定義模型導(dǎo)入相關(guān)API能力。
- 圖像Images：提供圖像相關(guān)API能力。
- 插件應(yīng)用：提供域內(nèi)知識(shí)搜索增強(qiáng)插件API相關(guān)能力。
Prompt工程：提供模版相關(guān)API能力。
大模型訓(xùn)練：提供創(chuàng)建訓(xùn)練任務(wù)、任務(wù)運(yùn)行、停止任務(wù)運(yùn)行及獲取任務(wù)運(yùn)行詳情等API能力。
大模型管理：提供獲取模型、模型版本詳情及將訓(xùn)練任務(wù)發(fā)布為模型等API能力。
大模型服務(wù)：提供創(chuàng)建服務(wù)、獲取服務(wù)詳情等API能力。
API 調(diào)用流程簡(jiǎn)介
API 的調(diào)用流程如下圖所示。
創(chuàng)建一個(gè)千帆應(yīng)用。根據(jù)實(shí)際需求創(chuàng)建千帆應(yīng)用，創(chuàng)建成功后，獲取AppID、API Key、Secret Key 等信息。
API 授權(quán)。對(duì)應(yīng)用的 AppID 進(jìn)行授權(quán)。
獲取接口訪問憑證 access_token 。根據(jù)第1步獲取的 API Key 和 Secret Key ，調(diào)用獲取access_token接口獲取 access_token ，通過 access_token 鑒權(quán)調(diào)用者身份。
調(diào)用API接口。例如調(diào)用ERNIE-Bot相關(guān)接口，詳見API列表。
API 調(diào)用流程
步驟一. 創(chuàng)建千帆應(yīng)用
（1）登錄百度智能云千帆控制臺(tái)。
請(qǐng)您注冊(cè)并登錄百度智能云千帆控制臺(tái) 。
注意：為保障服務(wù)穩(wěn)定運(yùn)行，賬戶最好不處于欠費(fèi)狀態(tài)。
（2）創(chuàng)建千帆應(yīng)用
進(jìn)入控制臺(tái)創(chuàng)建應(yīng)用 。
（3）創(chuàng)建應(yīng)用后，獲取AppID、API Key、Secret Key。
步驟二. 服務(wù)授權(quán)
應(yīng)用創(chuàng)建后，選擇對(duì)應(yīng)授權(quán)的公有云服務(wù)。
步驟三. 獲取訪問憑證
根據(jù)步驟一獲取的API Key、Secret Key，獲取access_token。參考以下獲取access_token，更多詳情方法請(qǐng)參考獲取access_token。
注意：access_token默認(rèn)有效期30天，生產(chǎn)環(huán)境注意及時(shí)刷新。
```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)
```
步驟四. 調(diào)用API接口
調(diào)用千帆提供的相關(guān)接口，如ERNIE-Bot等，詳見API列表。
在線調(diào)試
百度智能云千帆提供了 API在線調(diào)試平臺(tái)-示例代碼 ，用于幫助開發(fā)者調(diào)試接口，平臺(tái)集成快速檢索、查看開發(fā)文檔、查看在線調(diào)用的請(qǐng)求內(nèi)容和返回結(jié)果、復(fù)制和下載示例代碼等功能，簡(jiǎn)單易用，更多內(nèi)容請(qǐng)查看API在線調(diào)試介紹。
具體操作可查看視頻：<a target="_blank">快速上手API調(diào)用</a>。
三、重點(diǎn)詞匯或短語(yǔ)
在接入文心一言的過程中，以下幾個(gè)重點(diǎn)詞匯或短語(yǔ)需要特別注意：
1.API接口：指文心一言提供的服務(wù)接口，用戶可以通過調(diào)用接口，實(shí)現(xiàn)對(duì)文本數(shù)據(jù)的分析和處理。
2.情感分析：指通過自然語(yǔ)言處理技術(shù)，對(duì)文本的情感傾向進(jìn)行分析和判斷。情感分析是文心一言的重要功能之一，能夠幫助用戶了解文本的情感色彩和情感變化。
3.關(guān)鍵詞提取：指從文本中提取出重要的關(guān)鍵詞和短語(yǔ)。關(guān)鍵詞提取是文心一言的另一個(gè)重要功能，能夠幫助用戶快速了解文本的核心內(nèi)容和主題。
4.語(yǔ)言分類：指對(duì)文本進(jìn)行分類和歸類。文心一言可以根據(jù)文本的內(nèi)容和主題，對(duì)文本進(jìn)行分類和歸類，幫助用戶更好地了解文本的屬性和特征。
5.API密鑰：指用于身份驗(yàn)證和權(quán)限控制的重要憑證，必須妥善保管。在調(diào)用文心一言的API接口時(shí)，必須提供正確的API密鑰才能夠正常使用文心一言的服務(wù)。
總之，接入文心一言是一項(xiàng)非常重要的任務(wù)，能夠幫助用戶更好地了解和分析文本數(shù)據(jù)。同時(shí)，也需要妥善保管API密鑰，確保身份驗(yàn)證和權(quán)限控制的可靠性。