【ESP32 在線語音】如何運行 curl 腳本以及星火模型的調用測試
在各種大模型的API文檔中,經常會用到 curl 工具,那么——如何運行 curl 腳本呢?

在Linux平臺
對于復雜的代碼,建議創建腳本文件:
# 創建腳本文件
nano myscript.sh
然后執行以下指令
# 在文件中粘貼代碼,然后保存退出
chmod +x myscript.sh # 添加執行權限
./myscript.sh # 執行腳本
在Windows 平臺
首先編寫腳本文件(前提:已經下載安裝好 windows 版本的 curl),假設文件名為 curl-exe-script.ps1(注意尾綴為ps1)
# curl-exe-script.ps1
Write-Host "=== 使用真正的 cURL 工具 ===" -ForegroundColor Yellow
# ————————————————————以下均為示例——————————————————————
# 實例1:基本 GET 請求
curl.exe -s "https://httpbin.org/json"
# 實例2:下載文件
curl.exe -o "downloaded-file.jpg" "https://httpbin.org/image/jpeg"
Write-Host "文件下載完成"
# 實例3:帶 Header 的請求
curl.exe -H "User-Agent: My-Script" -H "Accept: application/json" "https://httpbin.org/headers"
# 實例4:POST 請求 with JSON
curl.exe -X POST "https://httpbin.org/post" `
-H "Content-Type: application/json" `
-d '{"name": "John", "email": "john@example.com"}' `
-s
執行前的準備工作:
默認情況下,PowerShell 的執行策略可能限制腳本運行。因此需要執行以下命令
# 檢查當前執行策略
Get-ExecutionPolicy
# 設置執行策略以允許腳本運行(需要管理員權限)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 或者臨時繞過(僅當前會話)
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
執行腳本
powershell
# 方法1: 直接執行
.\curl-script.ps1
# 方法2: 使用 PowerShell 命令
powershell -File .\curl-script.ps1
# 方法3: 帶參數執行
powershell -ExecutionPolicy Bypass -File .\curl-script.ps1
星火模型的調用:
1.1 了解星火 api
為方便用戶使用,我們提供了 原生 HTTP 來實現模型 API 的調用。
星火大模型 curl 調用幫助文檔如下:
https://www.xfyun.cn/doc/spark/HTTP%E8%B0%83%E7%94%A8%E6%96%87%E6%A1%A3.html

1.2 Http接口鑒權
注意: 該接口可以正式使用。如您需要申請使用,請點擊前往產品頁面領取免費額度。
tips:
計費包含接口的輸入和輸出內容;1 token 約等于1.5個中文漢字 或者 0.8個英文單詞;Spark Lite支持[搜索]內置插件;Spark Pro, Spark Max和Spark 4.0Ultra支持[搜索]、[天氣]、[日期]、[詩詞]、[字詞]、[股票]六個內置插件;Spark 4.0Ultra/Max現已支持system、Function Calling,tools 功能;Spark 4.0Ultra版本現已支持返回檢索引用信源信息。。
Curl請求腳本如下:
curl -i -k -X POST 'https://spark-api-open.xf-yun.com/v1/chat/completions' \
--header 'Authorization: Bearer key123456:secret123456' \#注意此處把“123456”替換為自己的APIPassword
--header 'Content-Type: application/json' \
--data '{
"model":"generalv3.5", (!注意此處,需要修改)
"messages": [
{
"role": "user",
"content": "來一個只有程序員能聽懂的笑話"
}
]
}'
在上面的model中選擇你的應用相匹配的model,否則可能出現11200錯誤。

v3.5 在應用列表中找不到了,好像已經不能使用了(2025年10月27日),因此需要將上面的
"model":"generalv3.5"進行修改,可以用 Spark Ultra-32K,修改為 "model":"4.0Ultra"
可以改成的參數如下:
| 參數名稱 | 類型 | 是否必傳 | 取值范圍 | 描述 |
|---|---|---|---|---|
| model | string | 是 | 4.0Ultra generalv3.5(懷疑不能用了) max-32k generalv3 pro-128k lite |
指定訪問的模型版本: 4.0Ultra指向4.0 Ultra版本; generalv3.5指向Max版本; max-32k指向Max-32K版本; generalv3指向Pro版本; pro-128k指向Pro-128K版本; lite指向Lite版本; |
參考資料:
CSDN博主「2345VOR」
原文鏈接:https://blog.csdn.net/vor234/article/details/140594209
curl windows安裝包:
https://curl.se/windows/

浙公網安備 33010602011771號