1. 准备工作：获取讯飞星火API密钥
在开始调用讯飞星火API之前，我们需要先完成一些准备工作。这个过程其实很简单，就像你注册一个新APP一样容易。我去年第一次使用时，只花了不到10分钟就搞定了全部设置。
首先打开讯飞开放平台官网（https://www.xfyun.cn/），点击右上角的\”注册\”按钮。这里有个小技巧：建议使用常用邮箱注册，因为后续的API调用通知和额度提醒都会发送到这个邮箱。注册完成后别急着退出，系统会自动跳转到控制台页面。
在控制台左侧菜单找到\”我的应用\”，点击\”创建新应用\”。这里需要填写一些基本信息：
- 应用名称：建议用英文或拼音，比如\”my_first_spark_app\”
- 应用分类：根据你的实际用途选择，测试阶段可以选\”其他\”
- 应用描述：简单写几句，比如\”测试讯飞星火API功能\”
创建成功后，你会看到两个关键信息：
- AppID：一串数字，相当于你的应用身份证
- API Key：一串字母数字组合的密钥，需要妥善保管
这两个信息就是我们后续调用API的通行证。我建议把它们保存在安全的地方，比如密码管理器，或者直接复制到代码里（当然生产环境要用环境变量保护起来）。
2. 安装必要的Python库
现在我们来准备Python环境。讯飞星火API支持标准的HTTP请求调用方式，所以只需要最基础的requests库就够了。如果你还没有安装，可以用pip快速安装：
pip install requests
我推荐使用Python 3.8或更高版本，因为新版本对异步请求的支持更好。在实际项目中，你可能还需要处理JSON数据，不过Python标准库中的json模块已经足够用了。
为了验证环境是否配置正确，可以创建一个test.py文件，写入以下代码：
import requests
import json
print(\”环境检查通过！\”)
运行这个脚本如果没有报错，说明基础环境已经OK。有时候新手会遇到SSL证书问题，如果出现相关错误，可以尝试更新pip和setuptools：
pip install –upgrade pip setuptools
3. 编写第一个API调用代码
现在进入最核心的部分——编写调用代码。讯飞星火API提供了多种服务，我们先从最简单的文本生成开始。以下是一个完整的示例代码，我会逐行解释关键部分：
import requests
import json
import hashlib
import base64
import time
# 配置你的API信息
APP_ID = \”你的AppID\”
API_KEY = \”你的API Key\”
API_SECRET = \”你的API Secret\”
# 构造请求头
def build_header():
cur_time = str(int(time.time()))
m = hashlib.md5()
m.update((API_KEY + cur_time + API_SECRET).encode(\’utf-8\’))
check_sum = m.hexdigest()
header = {
\’X-CurTime\’: cur_time,
\’X-Param\’: \’\’,
\’X-Appid\’: APP_ID,
\’X-CheckSum\’: check_sum,
\’Content-Type\’: \’application/json\’
}
return header
# 构造请求体
def build_body(text):
data = {
\”header\”: {
\”app_id\”: APP_ID
},
\”parameter\”: {
\”chat\”: {
\”domain\”: \”general\”,
\”temperature\”: 0.5,
\”max_tokens\”: 2048
}
},
\”payload\”: {
