清明上河图视频生成项目

基于华为云码道（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.10+

python--version# 如果未安装，前往 https://www.python.org/downloads/ 下载

2. 安装依赖

cd qingming-shanghe-tu-video pip install-r requirements.txt

第二步：获取 API Key

1. 注册/登录 火山引擎控制台
2. 进入方舟（Ark）平台：https://console.volcengine.com/ark
3. 在左侧菜单找到「API Key 管理」→ 创建 API Key
4. 在「模型广场」中找到 Seedance 视频生成模型，记录模型 ID（如doubao-seedance-1-0-pro-250528）

第三步：配置环境变量

临时配置（当前窗口有效）：

$env:VOLC_API_KEY="你的方舟API Key"$env:SEEDANCE_MODEL_ID="doubao-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 命令一览

常用参数

提示词设计指南

好的提示词是生成高质量视频的关键。以下是针对清明上河图主题的设计要点：

1. 镜头运动

2. 动态元素清单

提示词中应包含 3-5 个动态元素，避免过多导致画面混乱：

• 自然元素：水波荡漾、柳枝摇曳、炊烟升起、薄雾流动
• 人物动态：行走、奔跑、交谈、叫卖、划船、挑担
• 物体动态：船只航行、幌旗飘动、衣袂飘动

3. 色调控制

色调关键词： - 主色：米黄、赭石、土褐、暖黄 - 点缀：青、蓝、红、绿 - 水面：淡蓝灰、淡青灰 - 光线：柔和暖阳、清晨薄雾、明暗交错

4. 提示词模板结构

{"title":"模板标题","description":"模板说明","mode":"image","prompt":"完整的视频描述提示词...","ratio":"16:9","duration":10,"watermark":false}

华为云码道（CodeArts）在项目中的角色

本项目从构思到实现，全程使用华为云码道（CodeArts）智能编码助手辅助开发：

体验 CodeArts：访问华为云码道控制台，创建智能编码会话，即可开始 AI 辅助开发。

课堂演示建议

演示流程（约 30 分钟）

学生实践任务

1. 基础任务：使用预设模板生成一段清明上河图动态视频
2. 进阶任务：修改提示词，改变镜头运动方向和动态元素
3. 挑战任务：设计 3 个分镜提示词，用批量生成脚本制作系列视频
4. 创意任务：选择其他古画（如千里江山图），编写提示词生成动态视频

评估标准

常见问题

python src/generate_video.py image-p"..."--image img.jpg-o out.mp4--ratio 9:16