PHP快速調用百度文心一言API接口全流程詳解

gitbox 2025-06-10

1. 流程概述

百度文心一言提供了包括古詩詞、現代詩詞及名言警句在內的隨機生成內容接口。本文將指導您如何使用PHP編寫程序，調用該API接口並獲取隨機的一句話。

2. 註冊百度文心一言API接口

2.1 獲取API Key

使用百度文心一言API前，需先申請API Key。請訪問百度文心一言官網完成註冊，並生成您的專屬API Key。

 
$url = 'https://v1.hitokoto.cn/'; //API接口地址
$key = ''; //填寫您申請的API Key

請將上面代碼中的$key替換為您獲得的API Key。

3. 發送HTTP請求

拿到API Key後，可以利用PHP的cURL擴展發送HTTP GET請求，調用API並獲取響應數據，API Key需作為參數傳遞。

 
$ch = curl_init(); //初始化cURL句柄
curl_setopt($ch, CURLOPT_URL, $url); //設置請求URL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); //返回結果作為字符串
$output = curl_exec($ch); //執行請求
curl_close($ch); //關閉句柄

此代碼段中，使用curl_init()創建句柄，curl_setopt()配置請求選項，curl_exec()執行請求，最後關閉連接。

4. 解析API響應

成功請求後，會得到JSON格式的響應。通過json_decode()解析為數組後，可提取“hitokoto”字段，即隨機生成的一句話。

 
$result = json_decode($output, true); //解析JSON為數組
$hitokoto = $result['hitokoto']; //獲取隨機句子
$from = $result['from']; //獲取出處信息

這裡用數組鍵名獲取所需數據，方便後續處理。

5. 輸出隨機生成的名言

最後將獲得的句子輸出到網頁或應用中。

 
echo '' . $hitokoto . ''; //輸出名言

echo語句將隨機名言呈現給客戶端。

6. 完整示例代碼

整合以上步驟，完整調用百度文心一言API的PHP代碼如下：

 
$url = 'https://v1.hitokoto.cn/'; //API接口地址
$key = ''; //填寫您的API Key
<p>$ch = curl_init(); //初始化cURL句柄<br>
curl_setopt($ch, CURLOPT_URL, $url); //設置請求URL<br>
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); //返回字符串結果<br>
$output = curl_exec($ch); //執行請求<br>
curl_close($ch); //關閉句柄</p>
<p>$result = json_decode($output, true); //解析JSON響應<br>
$hitokoto = $result['hitokoto']; //獲取隨機名言<br>
$from = $result['from']; //獲取出處</p>
<p>echo '' . $hitokoto . ''; //輸出名言<br>

以上代碼可以輕鬆實現調用百度文心一言接口，隨機獲取並顯示一句話，適合用於網頁展示及其他PHP項目。