清明上河图视频生成项目基于华为云码道CodeArts智能编码助手与Seedance 2.5视频生成模型复刻清明上河图原貌让千年古画活起来。项目简介本项目使用 AI 视频生成技术将静态的清明上河图或类似宋代市井风格画作转化为动态视频重现宋代汴京的市井繁华景象。通过精心设计的提示词Prompt让画面中的人物、船只、旗帜、炊烟等元素依次苏醒营造穿越时空回到宋代的沉浸式体验。核心工作流古画图片 ──→ CodeArts 辅助编写脚本 ──→ Seedance 2.5 图生视频 ──→ 动态视频输出 ↑ 精心设计的提示词Prompt项目特点图生视频 文生视频双模式既能基于古画图片生成动态视频也能纯文字描述生成宋代场景预设提示词模板内置 5 套针对清明上河图优化的提示词开箱即用批量分镜生成通过 JSON 配置文件批量提交多分镜任务一次性生成系列视频任务管理支持任务查询、失败重试、执行报告导出面向教学详细的实操步骤适合大学生课堂演示与动手实践目录结构qingming-shanghe-tu-video/ ├── README.md # 本文档实操指导 ├── requirements.txt # Python 依赖 ├── .env.example # 环境变量配置示例 ├── .gitignore # Git 忽略规则 ├── LICENSE # MIT 开源许可证 ├── src/ # 源代码 │ ├── generate_video.py # 核心视频生成脚本文生/图生/模板/查询 │ ├── batch_generate.py # 批量生成脚本 │ └── prompts/ # 预设提示词模板 │ ├── qingming_panorama.json # 市井全景苏醒 │ ├── qingming_bridge.json # 拱桥穿越特写 │ ├── qingming_river.json # 河上船只航行 │ ├── qingming_street.json # 街市烟火 │ └── qingming_text_only.json # 纯文生视频全景 ├── examples/ # 示例 │ ├── run_examples.ps1 # PowerShell 一键演示脚本 │ └── batch_config.json # 批量生成配置示例 ├── docs/ # 补充文档 │ ├── api-reference.md # API 参数参考 │ └── troubleshooting.md # 常见问题排查 └── assets/ # 素材目录放入古画图片 └── .gitkeep快速开始第一步环境准备1. 安装 Python 3.10python--version# 如果未安装前往 https://www.python.org/downloads/ 下载2. 安装依赖cd qingming-shanghe-tu-video pip install-r requirements.txt第二步获取 API Key注册/登录 火山引擎控制台进入方舟Ark平台https://console.volcengine.com/ark在左侧菜单找到「API Key 管理」→ 创建 API Key在「模型广场」中找到 Seedance 视频生成模型记录模型 ID如doubao-seedance-1-0-pro-250528第三步配置环境变量临时配置当前窗口有效$env:VOLC_API_KEY你的方舟API Key$env:SEEDANCE_MODEL_IDdoubao-seedance-1-0-pro-250528永久配置推荐[Environment]::SetEnvironmentVariable(VOLC_API_KEY,你的方舟API Key,User)[Environment]::SetEnvironmentVariable(SEEDANCE_MODEL_ID,doubao-seedance-1-0-pro-250528,User)# 设置后重启 PowerShell 窗口生效验证配置$env:VOLC_API_KEY# 应显示你的 API Key$env:SEEDANCE_MODEL_ID# 应显示模型 ID第四步准备素材将清明上河图图片放入assets/目录# 例如将图片复制到 assets 目录Copy-Item你的图片路径\qingming.webp.\assets\支持的图片格式.jpg、.jpeg、.png、.webp、.bmp、.gif第五步生成视频方式一使用预设模板推荐新手# 查看可用模板python src/generate_video.py templates# 使用市井全景苏醒模板生成视频python src/generate_video.py template qingming_panorama --image./assets/qingming.webp -o./output/panorama.mp4方式二图生视频自定义提示词python src/generate_video.py image -p镜头缓缓拉近石拱桥桥上行人的衣袂在微风中飘动河面波光粼粼一艘木船从桥下穿过。色调保持古画暖黄质感。--image./assets/qingming.webp -o./output/bridge.mp4 --ratio 16:9 --duration 10方式三文生视频不依赖图片python src/generate_video.py text -p宋代汴京清晨薄雾笼罩河面木船缓缓航行河岸商铺幌旗招展行人往来如织炊烟袅袅阳光穿透薄雾洒下暖色柔光工笔画风格。-o./output/text_scene.mp4 --ratio 16:9 --duration 5方式四批量生成多分镜系列# 1. 编辑批量配置文件# 打开 examples/batch_config.json按需修改提示词和图片路径# 2. 执行批量生成python src/batch_generate.py--config examples/batch_config.json# 3. 如果有任务失败可以重试python src/batch_generate.py--config examples/batch_config.json--retry-failed方式五一键演示运行所有示例# 运行 PowerShell 演示脚本依次执行所有示例.\examples\run_examples.ps1第六步查看结果生成的视频保存在output/目录lsoutput/# panorama.mp4 - 市井全景苏醒# bridge.mp4 - 拱桥穿越特写# text_scene.mp4 - 纯文生视频# scene_01_panorama.mp4 - 批量生成结果# ...命令参考generate_video.py 命令一览命令说明示例text文生视频python generate_video.py text -p 描述 -o out.mp4image图生视频python generate_video.py image -p 描述 --image img.jpg -o out.mp4template模板生成python generate_video.py template qingming_panorama --image img.jpg -o out.mp4templates列出模板python generate_video.py templatesquery查询任务python generate_video.py query -t cgt-xxxx常用参数参数说明可选值--prompt/-p视频描述提示词任意中文/英文描述--image本地图片路径.jpg.png.webp等--image-url图片 URLhttps://...--output/-o输出文件路径任意.mp4路径--ratio宽高比16:9/9:16/1:1--duration视频时长秒5/10取决于模型支持--watermark添加水印无参数加上即生效提示词设计指南好的提示词是生成高质量视频的关键。以下是针对清明上河图主题的设计要点1. 镜头运动运镜方式提示词写法适用场景缓推进“镜头缓缓向前推进”全景苏醒、整体展示平移“镜头沿街道缓缓平移”街市长卷展示仰拍上升“从桥下水面仰拍升至桥面”拱桥穿越特写跟随“镜头跟随一艘木船前行”河上船只航行2. 动态元素清单提示词中应包含 3-5 个动态元素避免过多导致画面混乱自然元素水波荡漾、柳枝摇曳、炊烟升起、薄雾流动人物动态行走、奔跑、交谈、叫卖、划船、挑担物体动态船只航行、幌旗飘动、衣袂飘动3. 色调控制色调关键词 - 主色米黄、赭石、土褐、暖黄 - 点缀青、蓝、红、绿 - 水面淡蓝灰、淡青灰 - 光线柔和暖阳、清晨薄雾、明暗交错4. 提示词模板结构{title:模板标题,description:模板说明,mode:image,prompt:完整的视频描述提示词...,ratio:16:9,duration:10,watermark:false}华为云码道CodeArts在项目中的角色本项目从构思到实现全程使用华为云码道CodeArts智能编码助手辅助开发环节CodeArts 的作用需求分析通过对话式交互梳理项目需求、确定技术方案代码编写自动生成 API 调用脚本、批量生成脚本、提示词模板提示词设计根据古画画面分析结果生成针对性的视频提示词调试优化语法检查、错误排查、参数调整文档生成自动编写 README、API 参考文档、故障排查指南项目管理项目目录结构规划、Git 配置文件生成体验 CodeArts访问华为云码道控制台创建智能编码会话即可开始 AI 辅助开发。课堂演示建议演示流程约 30 分钟时间内容操作5 min项目背景介绍讲解清明上河图与 AI 视频生成5 min环境配置演示现场配置 API Key、安装依赖10 min核心功能演示运行图生视频、展示生成过程5 min提示词讲解分析提示词设计要点5 min学生动手实践修改提示词、尝试生成学生实践任务基础任务使用预设模板生成一段清明上河图动态视频进阶任务修改提示词改变镜头运动方向和动态元素挑战任务设计 3 个分镜提示词用批量生成脚本制作系列视频创意任务选择其他古画如千里江山图编写提示词生成动态视频评估标准维度评分要点功能完成视频成功生成并能播放提示词质量描述具体、动态元素丰富、色调控制合理创意性镜头设计有新意、场景选择独特技术理解能解释 API 调用流程、参数含义常见问题Q: 提示词应该用中文还是英文Seedance 模型支持中英文提示词。本项目的预设模板使用中文因为中文能更精确地描述中国古画的意境和色调。你也可以尝试英文提示词对比效果。Q: 视频生成需要多长时间通常 5 秒视频需要 1-3 分钟10 秒视频需要 2-5 分钟具体取决于模型负载。脚本默认轮询超时为 600 秒10 分钟可通过环境变量SEEDANCE_POLL_TIMEOUT调整。Q: 图片大小有限制吗本地图片会转为 base64 编码发送建议图片大小不超过 10MB。过大的图片可能导致请求超时。如图片过大可先用工具压缩。Q: 生成失败怎么办检查 API Key 和模型 ID 是否正确查看错误信息中的 HTTP 状态码和响应内容参考docs/troubleshooting.md排查网络 问题可适当增加轮询超时Q: 如何生成竖屏视频将--ratio参数改为9:16即可python src/generate_video.py image-p...--image img.jpg-o out.mp4--ratio 9:16更多问题请参考 docs/troubleshooting.md。技术栈技术说明Python 3.10编程语言requestsHTTP 请求库Seedance 2.5字节跳动视频生成模型火山引擎方舟平台华为云码道 CodeArtsAI 智能编码助手项目开发工具贡献指南欢迎提交 Issue 和 Pull RequestFork 本仓库创建特性分支git checkout -b feature/new-prompt提交更改git commit -m 添加新提示词模板推送分支git push origin feature/new-prompt创建 Pull Request欢迎贡献的内容新的提示词模板不同古画、不同镜头风格代码优化与 Bug 修复文档翻译与改进新功能建议如视频拼接、配乐等致谢清明上河图北宋画家张择端绘制的传世名画本项目的灵感来源火山引擎方舟平台提供 Seedance 视频生成模型 API华为云码道 CodeArtsAI 智能编码助手辅助本项目开发