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 用于后續(xù)請求鑒權(quán)。
調(diào)用對話接口
Endpoint：
https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token=YOUR_TOKEN請求參數(shù)（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"]
}
}
]
}響應(yīng)解析
result：模型生成的文字回復(fù)function_call：若模型觸發(fā)函數(shù)，則返回函數(shù)名與參數(shù)usage：Token 使用詳情，用于成本監(jiān)控與限流system、assistant、user 三種角色字段，精準(zhǔn)控制系統(tǒng)指令、模型回復(fù)與用戶輸入。function_call。function_call.name 和 arguments 調(diào)用相應(yīng)后端接口。role:"function" 的消息插入 messages，再次調(diào)用對話接口，完成業(yè)務(wù)閉環(huán)。# 示例：Python 調(diào)用流程
import requests, json
# 1. 獲取 token（略）
token = "YOUR_ACCESS_TOKEN"
# 2. 構(gòu)造對話
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. 若觸發(fā) function_call
if "function_call" in resp:
args = json.loads(resp["function_call"]["arguments"])
# 調(diào)用真實(shí)天氣 API
weather_info = get_weather_api(args["location"], args["date"])
# 插入函數(shù)返回
messages.append(resp)
messages.append({"role":"function","name":"get_weather","content":json.dumps(weather_info)})
# 再次調(diào)用，獲得最終用戶回復(fù)
final = requests.post(...).json()
print(final["result"])生成參數(shù)調(diào)優(yōu)：
temperature: 0.2–0.5 提升穩(wěn)定性top_p: 0.8–1.0 控制多樣性penalty_score: > 1 避免重復(fù)usage 字段監(jiān)控 Token 消耗，合理配置熔斷與重試策略。need_clear_history 進(jìn)行敏感內(nèi)容監(jiān)測，確保數(shù)據(jù)治理合規(guī)。API Key 與 Secret Key，實(shí)現(xiàn)調(diào)用隔離與審計(jì)。百度“千帆”開放平臺為 文心一言 API 提供多語言 SDK（Python、Java、Node.js 等）、插件市場、示例工程，并與釘釘、飛書、微信等多端深度集成，形成完整生態(tài)。支持第三方開發(fā)者在電商、教育、醫(yī)療、制造業(yè)等領(lǐng)域快速創(chuàng)新與交付。
文心一言 API 憑借中文原生優(yōu)勢、知識增強(qiáng)能力和函數(shù)調(diào)用機(jī)制，為對話式 AI 帶來全新可能。隨著多模態(tài)融合與行業(yè)定制化進(jìn)程加速，未來可在更多垂直場景實(shí)現(xiàn)智能助手全流程落地。開發(fā)者只需幾行代碼，即可接入百度 AI 對話服務(wù)，快速搭建高效、可靠、合規(guī)的智能體驗(yàn)。
?? 快速上手推薦
希望本篇文章能幫助你全面掌握文心一言 API 的技術(shù)要點(diǎn)與最佳實(shí)踐，助力 AI 對話項(xiàng)目快速落地。祝你開發(fā)順利！
原文引自YouTube視頻：https://www.youtube.com/watch?v=toZsVQyH4PA
微信截圖_17363901826052.png)
微信截圖_17413321624196.png)
鍵.png)