
FastAPI是什么?快速上手指南
獲取 Access Token
curl -X POST "https://aip.baidubce.com/oauth/2.0/token" \
-d "grant_type=client_credentials&client_id=API_KEY&client_secret=SECRET_KEY"
成功返回 access_token
用于后續請求鑒權。
調用對話接口
Endpoint:
https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token=YOUR_TOKEN
請求參數(JSON):
{
"messages": [
{"role":"system","content":"你是一個智能助手,精通中文對話。"},
{"role":"user","content":"幫我查下北京明天天氣。"}
],
"temperature":0.5,
"top_p":0.9,
"functions": [
{
"name":"get_weather",
"description":"獲取天氣信息",
"parameters":{
"type":"object",
"properties":{
"location":{"type":"string"},
"date":{"type":"string"}
},
"required":["location","date"]
}
}
]
}
響應解析
result
:模型生成的文字回復function_call
:若模型觸發函數,則返回函數名與參數usage
:Token 使用詳情,用于成本監控與限流system
、assistant
、user
三種角色字段,精準控制系統指令、模型回復與用戶輸入。function_call
。function_call.name
和 arguments
調用相應后端接口。role:"function"
的消息插入 messages
,再次調用對話接口,完成業務閉環。# 示例:Python 調用流程
import requests, json
# 1. 獲取 token(略)
token = "YOUR_ACCESS_TOKEN"
# 2. 構造對話
messages = [
{"role":"system","content":"你是智能助手。"},
{"role":"user","content":"告訴我深圳明天下雨概率。"}
]
functions = [{
"name":"get_weather",
"description":"查詢天氣",
"parameters":{
"type":"object",
"properties":{
"location":{"type":"string"},
"date":{"type":"string"}
},
"required":["location","date"]
}
}]
# 3. 首次請求
resp = requests.post(
f"https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token={token}",
json={"messages":messages, "functions":functions}
).json()
# 4. 若觸發 function_call
if "function_call" in resp:
args = json.loads(resp["function_call"]["arguments"])
# 調用真實天氣 API
weather_info = get_weather_api(args["location"], args["date"])
# 插入函數返回
messages.append(resp)
messages.append({"role":"function","name":"get_weather","content":json.dumps(weather_info)})
# 再次調用,獲得最終用戶回復
final = requests.post(...).json()
print(final["result"])
生成參數調優:
temperature
: 0.2–0.5 提升穩定性top_p
: 0.8–1.0 控制多樣性penalty_score
: > 1 避免重復usage
字段監控 Token 消耗,合理配置熔斷與重試策略。need_clear_history
進行敏感內容監測,確保數據治理合規。API Key
與 Secret Key
,實現調用隔離與審計。百度“千帆”開放平臺為 文心一言 API 提供多語言 SDK(Python、Java、Node.js 等)、插件市場、示例工程,并與釘釘、飛書、微信等多端深度集成,形成完整生態。支持第三方開發者在電商、教育、醫療、制造業等領域快速創新與交付。
文心一言 API 憑借中文原生優勢、知識增強能力和函數調用機制,為對話式 AI 帶來全新可能。隨著多模態融合與行業定制化進程加速,未來可在更多垂直場景實現智能助手全流程落地。開發者只需幾行代碼,即可接入百度 AI 對話服務,快速搭建高效、可靠、合規的智能體驗。
?? 快速上手推薦
希望本篇文章能幫助你全面掌握文心一言 API 的技術要點與最佳實踐,助力 AI 對話項目快速落地。祝你開發順利!
原文引自YouTube視頻:https://www.youtube.com/watch?v=toZsVQyH4PA