Arduino UNO Q 讲好中国儿童故事

本示例国产大模型睡前故事讲述器是一个使用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大小。

使用说明

1. 启动应用后，您会看到一个带有精美背景的Streamlit界面，
2. 在左侧边栏中设置故事参数：
年龄段： 选择适合的年龄段（3-5岁、6-8岁、9-12岁、13-16岁）
故事主题： 选择故事类型（奇幻/冒险、童话、成语故事、西游记、科学/宇宙、动物、喜剧、红色经典）
故事语调：选择叙述风格（平静甜美、史诗冒险、活泼愉快等）
结局类型：选择故事结尾方式（快乐安心、开放式神秘等）
叙事结构：选择故事结构（经典、分章节、系列剧式）
故事时长：选择故事长度（短篇、中篇、长篇）
3. 点击"生成故事"按钮，科大讯飞Spark X1.5将根据您的设置生成个性化中文故事，
4. 或点击"随机生成"按钮，系统会随机选择参数生成故事。

较原厂程序笔者的方案更加简单，更加容易理解。融入中国元素，契合国情使开源硬件在中国落地生根，枝繁叶茂。以此示例建议大家在应用中多采用国产大语言模型，这样国产大语言模型才能越做越好，越来越聪明。