必须先完成实名认证并创建应用获取API凭证，才能调用讯飞星火大模型；路径为：注册→实名认证→控制台创建应用→获取SPARKAI_APP_ID等参数；调用时需用正确URL、model参数及流式处理逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用讯飞星火大模型做智能对话、文本生成或接入自己的应用，必须先拿到合法可用的API接口权限和调用凭证，否则所有代码都会返回401或invalid app_id错误。
申请API接口权限的完整路径
第一步：访问讯飞星火官方入口 https://xinghuo.xfyun.cn/，点击右上角「立即体验」或「申请内测」按钮，跳转至统一登录/注册页。
第二步：用手机号完成注册，随后必须进行【实名认证】——未实名的账号无法创建应用、看不到API密钥、也无法领取免费额度，这一步卡住90%的新手。
第三步：登录后进入控制台 → 左侧导航栏点击「星火认知大模型」→ 点击「创建应用」，填写应用名称（如“个人笔记AI助手”）、选择分类（工具类/教育类等）、简要描述功能，提交后系统自动审核，通常5分钟内通过，无需人工干预。
第四步：审核通过后，回到「我的应用」列表，点击刚创建的应用名称，进入详情页——这里会直接显示 SPARKAI_APP_ID、SPARKAI_API_KEY、SPARKAI_API_SECRET 三个关键参数，以及 Spark Pro 对应的 SPARKAI_URL 和 SPARKAI_DOMAIN。
HTTP方式调用Spark Pro模型（推荐新手）
方法一：使用curl快速验证（复制即用）
打开终端，粘贴以下命令，把 YOUR_API_KEY 替换为你应用页里看到的 SPARKAI_API_KEY：
curl -X POST "https://spark-api-open.xf-yun.com/v1/chat/completions" \<br> -H "Authorization: Bearer YOUR_API_KEY" \<br> -H "Content-Type: application/json" \<br> -d '{ "model": "pro", "messages": [{"role": "user", "content": "你好"}], "stream": false}'
将小说章节转换为电影分镜剧本。用户上传txt/md/docx文本，AI分析场景、角色、情绪、镜头语言，输出专业分镜脚本。适用于用户提及“分镜”“storyboard”“小说转分镜”“影视改编”“镜头脚本”或需要将小说改编为分镜的场景。
注意：Spark Pro 的 model 参数必须填 【pro】，填错成 lite 或 v3.5 将返回400错误；URL必须用 spark-api-open.xf-yun.com，旧域名已停用。
Python代码调用（含流式响应处理）
第一步：安装依赖库
执行 pip install requests，无需额外SDK，纯requests即可驱动。
第二步：准备请求头与基础参数
将控制台获取的四个参数全部填入变量：
SPARKAI_APP_ID = "your_app_id"
SPARKAI_API_KEY = "your_api_key"
SPARKAI_API_SECRET = "your_api_secret"
SPARKAI_URL = "https://spark-api-open.xf-yun.com/v1/chat/completions"
第三步：构造请求体并发送
务必设置 "stream": True，否则无法接收逐字返回的流式内容；"model" 字段值必须与你在控制台选择的模型完全一致（例如 Spark Pro 就写 "pro"），大小写敏感。
第四步：逐块解析响应流
用 response.iter_lines() 循环读取每行 data: 开头的 SSE 数据，用 json.loads(line[6:]) 提取 content 字段，遇到空行或 error 字段立即终止循环——不处理空行会导致 decode error。
