文心一言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 target="_blank">快速上手API調用</a>。
三、重點詞匯或短語
在接入文心一言的過程中，以下幾個重點詞匯或短語需要特別注意：
1.API接口：指文心一言提供的服務接口，用戶可以通過調用接口，實現對文本數據的分析和處理。
2.情感分析：指通過自然語言處理技術，對文本的情感傾向進行分析和判斷。情感分析是文心一言的重要功能之一，能夠幫助用戶了解文本的情感色彩和情感變化。
3.關鍵詞提取：指從文本中提取出重要的關鍵詞和短語。關鍵詞提取是文心一言的另一個重要功能，能夠幫助用戶快速了解文本的核心內容和主題。
4.語言分類：指對文本進行分類和歸類。文心一言可以根據文本的內容和主題，對文本進行分類和歸類，幫助用戶更好地了解文本的屬性和特征。
5.API密鑰：指用于身份驗證和權限控制的重要憑證，必須妥善保管。在調用文心一言的API接口時，必須提供正確的API密鑰才能夠正常使用文心一言的服務。
總之，接入文心一言是一項非常重要的任務，能夠幫助用戶更好地了解和分析文本數據。同時，也需要妥善保管API密鑰，確保身份驗證和權限控制的可靠性。