本示例国产大模型睡前故事讲述器是一个使用Arduino UNO Q构建的生成式AI应用，通过HTTP API直接调用科大讯飞Spark X1.5大语言模型，根据用户选择的参数创建个性化中文睡前故事。应用使用Streamlit构建直观的用户界面，支持实时参数调整和故事生成。
主要功能：
使用科大讯飞Spark X1.5大语言模型生成高质量中文睡前故事。
通过HTTP API直接调用，无需额外的原厂LLM Brick，更加适合中国网络环境，
使用Streamlit构建的现代化UI界面，带有精美国产动画背景图片，
支持多种故事参数自定义：年龄、主题、语调、结局类型、叙事结构、时长等，
支持随机生成故事功能，一键创建中国元素的成语故事，红色经典等积极教育意义的故事，
响应式设计，适配不同设备屏幕。
硬件：
Arduino UNO Q (x1)
USB-C电缆（用于供电和编程）(x1)
软件:
Arduino App Lab
科大讯飞Spark X1.5 API密钥
此示例需要有效的互联网连接以访问AI提供商的API。您还需要使用的服务的有效API密钥，目前科大讯飞Spark X1.5提供免费服务值得推荐。此外科大讯飞开源了API调用的示例方便二次开发。
下图中密钥为APIPassword，点击文档在跳转页面下载示例程序
引入WebUI - Streamlit金砖配置
python程序main.py输入：
# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
#
# SPDX-License-Identifier: MPL-2.0
import re
import os
import json
import datetime
import hashlib
import hmac
import base64
import urllib.parse
import requests
from arduino.app_utils import App
# 科大讯飞Spark X1.5 API配置
SPARK_API_KEY = "你申请的密钥"
SPARK_API_URL = "https://spark-api-open.xf-yun.com/v2/chat/completions"
def call_spark_api(prompt):
"""调用科大讯飞Spark X1.5 API"""
headers = {
"Authorization": f"Bearer {SPARK_API_KEY}",
"Content-Type": "application/json"
}
# 构建请求体
data = {
"model": "spark-x",
"messages": [
{
"role": "system",
"content": "你是一个擅长讲述中国传统文化故事的儿童睡前故事讲述者。你的回答必须是故事本身，直接用HTML格式呈现。不要将回答包装在markdown代码块或任何其他格式中。使用<h1>、<h2>等标签作为标题和副标题。使用<strong>或<b>标签表示粗体文本。包含相关的表情符号。如果故事是分章节的，使用标题标签作为章节标题。请用中文回复，确保故事内容适合儿童睡前阅读。特别擅长讲述成语故事、西游记等经典名著、红色经典故事等中国传统文化题材。"
},
{
"role": "user",
"content": prompt
}
],
"stream": False, # Streamlit UI不适合流式响应，改为非流式
"temperature": 0.8,
"max_tokens": 2048
}
try:
response = requests.post(SPARK_API_URL, headers=headers, json=data, timeout=60)
if response.status_code == 200:
result = response.json()
if 'choices' in result and len(result['choices']) > 0:
return result['choices'][0]['message']['content']
else:
return "API返回了无效的响应格式"
else:
return f"API请求失败，状态码: {response.status_code}, 错误信息: {response.text}"
except Exception as e:
return f"API调用异常: {str(e)}"
def generate_stories_app():
"""使用Streamlit UI构建故事生成应用"""
import streamlit as st
st.set_page_config(
page_title="国产大模型睡前故事讲述器",
page_icon="🏰",
layout="wide"
)
# 读取并编码背景图片
import base64
try:
with open("assets/img/storyteller-background.png", "rb") as image_file:
encoded_string = base64.b64encode(image_file.read()).decode()
st.markdown(
f"""
<style>
.stApp {{
background-image: url("data:image/png;base64,{encoded_string}");
background-size: cover;
background-position: center;
background-repeat: no-repeat;
background-attachment: fixed;
}}
</style>
""",
unsafe_allow_html=True
)
except Exception as e:
st.error(f"无法加载背景图片: {e}")
st.title("🏰 国产大模型睡前故事讲述器")
# 创建侧边栏用于参数设置
st.sidebar.header("📚 故事参数设置")
# 年龄选择
age_options = ["3-5岁", "6-8岁", "9-12岁", "13-16岁"]
age = st.sidebar.selectbox("年龄段", age_options)
# 主题选择
theme_options = ["奇幻/冒险", "童话", "成语故事", "西游记", "科学/宇宙", "动物", "喜剧", "红色经典"]
theme = st.sidebar.selectbox("故事主题", theme_options)
# 语调选择
tone_options = ["平静甜美", "史诗冒险", "活泼愉快", "神秘好奇", "智慧深思", "紧张怪诞"]
tone = st.sidebar.selectbox("故事语调", tone_options)
# 结局类型
ending_options = ["快乐安心", "开放式神秘", "有道德寓意", "戏剧性但有希望"]
ending_type = st.sidebar.selectbox("结局类型", ending_options)
# 叙事结构
structure_options = ["经典", "分章节", "系列剧式"]
narrative_structure = st.sidebar.selectbox("叙事结构", structure_options)
# 故事时长
duration_options = ["短篇 5分钟", "中篇 10-15分钟", "长篇 20+分钟"]
duration = st.sidebar.selectbox("故事时长", duration_options)
# 其他要求
other = st.sidebar.text_area("其他要求（可选）", height=100)
# 生成按钮
generate_button = st.sidebar.button("📖 生成故事", type="primary")
# 随机生成按钮
random_button = st.sidebar.button("🎲 随机生成")
if random_button:
import random
age = random.choice(age_options)
theme = random.choice(theme_options)
tone = random.choice(tone_options)
ending_type = random.choice(ending_options)
narrative_structure = random.choice(structure_options)
duration = random.choice(duration_options)
st.sidebar.success("已随机选择参数！")
# 主内容区域
if generate_button:
# 创建提示
prompt = f"作为一个喜欢给{age}的孩子读睡前故事的家长，我需要一个愉快且适合年龄的故事。"
# 根据主题类型添加特定提示
if theme == "成语故事":
prompt += " 请创作一个基于中国成语的故事，解释成语的由来和含义，使用生动有趣的方式讲述。"
elif theme == "西游记":
prompt += " 请创作一个基于西游记人物和情节的冒险故事，保持原著的风格和价值观。"
elif theme == "红色经典":
prompt += " 请创作一个类似《鸡毛信》、《小兵张嘎》、《闪闪的红星》等红色经典的故事，传承革命精神和爱国情怀。"
else:
prompt += f" 故事类型是{theme}。"
prompt += f"语调应该是{tone}。"
prompt += f"请确保故事有{narrative_structure}的叙事结构，给孩子留下{ending_type}的感觉。"
prompt += f"长度应该大约是{duration}。语言应该易于理解，适合我孩子的年龄理解能力。"
prompt += "请在故事中加入适合中国儿童的文化元素和价值观念。"
if other:
prompt += f"\n\n其他可选的故事元素：{other}"
# 显示加载状态
with st.spinner("正在生成故事..."):
# 调用API生成故事
story = call_spark_api(prompt)
# 显示故事
st.header("📖 生成的故事")
st.markdown(story, unsafe_allow_html=True)
# 添加复制按钮
if st.button("📋 复制故事"):
st.write("故事已复制到剪贴板")
else:
st.info("请在左侧设置参数后点击\"生成故事\"按钮")
# 显示示例故事
st.header("📖 示例故事")
example_story = """
<h1>小兔子的冒险</h1>
<p>从前，有一只可爱的小兔子，它住在一个美丽的森林里...</p>
"""
st.markdown(example_story, unsafe_allow_html=True)
st.caption("这是一个示例故事，设置参数并点击生成按钮来创建您自己的故事！")
# 使用Streamlit运行应用
if __name__ == "__main__":
generate_stories_app()背景图片按照此路径assets/img/storyteller-background.png放置，尺寸笔者给的是1980x1024大小。
使用说明
-
启动应用后，您会看到一个带有精美背景的Streamlit界面，
-
在左侧边栏中设置故事参数：
年龄段： 选择适合的年龄段（3-5岁、6-8岁、9-12岁、13-16岁）
故事主题： 选择故事类型（奇幻/冒险、童话、成语故事、西游记、科学/宇宙、动物、喜剧、红色经典）
故事语调：选择叙述风格（平静甜美、史诗冒险、活泼愉快等）
结局类型：选择故事结尾方式（快乐安心、开放式神秘等）
叙事结构：选择故事结构（经典、分章节、系列剧式）
故事时长：选择故事长度（短篇、中篇、长篇）
-
点击"生成故事"按钮，科大讯飞Spark X1.5将根据您的设置生成个性化中文故事，
-
或点击"随机生成"按钮，系统会随机选择参数生成故事。
较原厂程序笔者的方案更加简单，更加容易理解。融入中国元素，契合国情使开源硬件在中国落地生根，枝繁叶茂。以此示例建议大家在应用中多采用国产大语言模型，这样国产大语言模型才能越做越好，越来越聪明。
