ESP32实战：星火大模型HTTP接口鉴权与Arduino高效对接指南-程序员充电站

1. ESP32与星火大模型对接概述

ESP32作为一款高性价比的Wi-Fi/蓝牙双模芯片，在物联网领域有着广泛应用。而讯飞星火大模型作为国产AI的代表，提供了强大的自然语言处理能力。将两者结合，可以打造出能听懂人话的智能硬件设备。

我最近在做一个智能家居项目时，就遇到了这样的需求：让ESP32设备能够理解用户的语音指令。经过多次尝试，发现通过HTTP接口调用星火大模型是最稳定的方案。相比WebSocket方案，HTTP短连接更适合资源有限的ESP32，开发难度也低很多。

2. 准备工作

2.1 硬件准备

你需要准备以下硬件：

ESP32开发板（推荐ESP32-S3，性能更好）
可靠的Wi-Fi网络（建议2.4GHz频段）
电脑和USB数据线

我实测过几款ESP32开发板，发现ESP32-S3在HTTP请求处理上表现最好。有一次用老款ESP32调试时，经常出现内存不足的问题，换成S3后立马稳定了。

2.2 软件环境配置

首先确保你的Arduino IDE已经安装好ESP32开发板支持：

打开Arduino IDE
文件 > 首选项 > 附加开发板管理器网址
添加：https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
工具 > 开发板 > 开发板管理器，搜索安装esp32

还需要安装几个关键库：

ArduinoJson（处理JSON数据）
HTTPClient（发送HTTP请求）

在库管理器中搜索安装即可。我建议使用ArduinoJson 6.x版本，这个版本内存占用更优化。

3. 星火API鉴权详解

3.1 获取API密钥

首先到讯飞开放平台（https://www.xfyun.cn）注册账号，创建应用后可以获得：

API Key：32位字符串
API Secret：32位字符串

这两个参数是鉴权的关键，务必妥善保管。我在开发时犯过一个错误：把密钥直接写在代码里上传到了GitHub，结果被别人盗用产生了高额费用。后来学会了用外部配置文件存储密钥。

3.2 鉴权原理

星火API采用Bearer Token鉴权方式，需要将API Key和Secret组合成一个特殊字符串。具体格式为：

Authorization: Bearer {API Key}:{API Secret}

这里有个坑要注意：冒号前后不能有空格！我第一次调试时就因为多加了空格，折腾了半天才找到问题。

4. Arduino代码实现

4.1 基础通信框架

先建立Wi-Fi连接，这是所有网络请求的基础：

#include <WiFi.h> #include <HTTPClient.h> #include <ArduinoJson.h> const char* ssid = "你的WiFi名称"; const char* password = "你的WiFi密码"; void setup() { Serial.begin(115200); WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println("WiFi连接成功"); }

4.2 封装API请求函数

这是最核心的部分，我优化了几次才稳定下来：

String callSparkAPI(String question) { HTTPClient http; http.begin("https://spark-api-open.xf-yun.com/v1/chat/completions"); // 鉴权头 String auth = "Bearer your_api_key:your_api_secret"; http.addHeader("Authorization", auth); http.addHeader("Content-Type", "application/json"); // 构造请求体 DynamicJsonDocument doc(1024); doc["model"] = "generalv3.5"; JsonArray messages = doc.createNestedArray("messages"); JsonObject systemMsg = messages.createNestedObject(); systemMsg["role"] = "system"; systemMsg["content"] = "你是一个智能家居助手，回答要简洁"; JsonObject userMsg = messages.createNestedObject(); userMsg["role"] = "user"; userMsg["content"] = question; String payload; serializeJson(doc, payload); // 发送请求 int httpCode = http.POST(payload); if (httpCode == 200) { String response = http.getString(); http.end(); DynamicJsonDocument resDoc(1024); deserializeJson(resDoc, response); return resDoc["choices"][0]["message"]["content"]; } else { http.end(); return "请求失败，错误码：" + String(httpCode); } }

4.3 完整示例代码

把上面两部分组合起来，加上主循环：

void loop() { if (Serial.available()) { String input = Serial.readStringUntil('\n'); input.trim(); Serial.println("思考中..."); String answer = callSparkAPI(input); Serial.println(answer); } delay(100); }

上传代码后，打开串口监视器（波特率115200），输入问题就能看到大模型的回复了。

5. 常见问题排查

5.1 网络连接问题

如果遇到连接超时（错误码-11）：

检查Wi-Fi信号强度
尝试降低HTTP超时时间（http.setTimeout(10000)）
更换更简单的SSID和密码（避免特殊字符）

5.2 API返回错误

常见错误码：

400：请求格式错误，检查JSON结构
401：鉴权失败，检查API Key和Secret
429：请求过于频繁

5.3 内存优化技巧

ESP32内存有限，可以：

使用ArduinoJson的DynamicJsonDocument时控制大小
及时释放HTTPClient资源
避免在循环中创建大对象

6. 进阶应用

6.1 语音输入输出

结合麦克风和扬声器模块，可以实现完整的语音交互。我用的方案是：

INMP441麦克风模块采集语音
通过HTTP接口发送到语音识别服务
将识别文本传给星火大模型
用TTS服务将回复转为语音播放

6.2 多轮对话实现

要支持上下文对话，需要在请求中保留历史消息：

JsonArray messages = doc.createNestedArray("messages"); // 添加历史对话 for (int i = 0; i < chatHistory.size(); i++) { JsonObject msg = messages.createNestedObject(); msg["role"] = chatHistory[i].role; msg["content"] = chatHistory[i].content; } // 添加新问题 JsonObject newMsg = messages.createNestedObject(); newMsg["role"] = "user"; newMsg["content"] = question;