AI视频创作

> 数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。

支持两种视频创作模式：

• 文生视频：输入文字描述，AI 自动生成画面连贯、风格鲜明的短视频，支持指定分辨率、宽高比、时长
• 图生视频：提供首帧图片，AI 让图片动起来，支持指定分辨率、时长，可选配音

生成完成后自动下载 mp4 文件保存到本地，同时返回在线访问链接（有效期24小时）。

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 AI视频创作 API 页面，点击「申请使用」
3. 完成实名认证（本接口需要个人或企业实名认证，并提供应用场景说明）
4. 审核通过后在「我的API」中获取 AppKey
5. 配置 Key（三选一）：

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_VIDEO_KEY=你的AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_VIDEO_KEY=你的AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/video_generate.py --key 你的AppKey "夕阳下的海边"

> 注意：视频生成为异步任务，通常需要 1~5 分钟，脚本会自动每 15 秒轮询一次，最长等待 6 分钟。

使用方法

文生视频（基础）

python scripts/video_generate.py "夕阳下的海边，海浪轻柔拍打礁石，写实风格"

输出示例：

🎬 提交文生视频任务...
   提示词: 夕阳下的海边，海浪轻柔拍打礁石，写实风格
   分辨率: 480P  宽高比: 16:9  时长: 5秒  预计消耗: 5次

✅ 任务已提交，订单号: JH819251208164211x1hC5
   （如需中断，可稍后用 --query JH819251208164211x1hC5 重新查询）

⏳ 等待视频生成（视频通常需 1-5 分钟，最长等待 360s）...
   状态: RUNNING...  已等待 60s

✅ 视频生成成功！
   订单号: JH819251208164211x1hC5
   在线链接: https://...（24小时内有效）

📥 正在下载视频...
   本地文件: output/video_20260327_153022.mp4

指定分辨率、宽高比、时长

# 1080P 横屏 10秒（消耗 3×10=30 次）
python scripts/video_generate.py "城市夜景，霓虹灯闪烁" --resolution 1080P --proportion 16:9 --duration 10

# 720P 竖屏 5秒（适合短视频平台，消耗 2×5=10 次）
python scripts/video_generate.py "唯美樱花林小径" --resolution 720P --proportion 9:16

# 480P 正方形 5秒（最省次数，消耗 1×5=5 次）
python scripts/video_generate.py "云朵在天空飘动" --proportion 1:1

可用分辨率（直接影响消耗次数）：

可用宽高比（仅文生视频支持）：

可用时长：

> 计费公式：次数消耗 = 分辨率系数 × 时长（秒）

> 例如：1080P × 10秒 = 3 × 10 = 30次

添加反向提示词

# 不希望出现的内容（限制画面元素）
python scripts/video_generate.py "夏日海滩" --negative "人群、垃圾、建筑物"

关闭提示词智能改写

# 默认开启智能改写（AI 会优化你的提示词）
# --no-extend 关闭后，严格按照原始提示词生成
python scripts/video_generate.py "一只小猫追蝴蝶" --no-extend

图生视频

# 图片 URL + 运动描述（prompt 为必填）
python scripts/video_generate.py --image https://example.com/flower.jpg --prompt "让花朵慢慢绽放"

# 指定分辨率和时长
python scripts/video_generate.py --image https://example.com/photo.jpg --prompt "手舞足蹈" --resolution 720P --duration 10

# 添加配音（wav/mp3，3-30秒，不超过10MB）
python scripts/video_generate.py --image https://example.com/photo.jpg --prompt "人物微笑点头" --audio https://example.com/bgm.mp3

图片要求：

• 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP
• 分辨率：宽高均在 360~2000 像素之间
• 文件大小：不超过 5MB
• 支持 URL 或 Base64 编码（格式：data:{MIME_type};base64,{base64_data}）

> 图生视频的宽高比由输入图片自动决定，不支持单独指定 --proportion。

指定输出目录

python scripts/video_generate.py "城市夜景，霓虹灯闪烁" --output ~/Desktop/my_videos

仅获取链接（不下载）

python scripts/video_generate.py "水墨山水，云雾缭绕" --no-download

查询已提交任务

任务提交后如需中断等待，可稍后手动查询：

python scripts/video_generate.py --query JH819251208164211x1hC5

AI 使用指南

当用户要求创建/生成/制作视频时，按以下步骤操作：

1. 判断模式 — 用户提供图片链接时使用图生视频模式（需同时有动作描述），否则使用文生视频模式
2. 提取参数 — 识别分辨率需求（默认480P）、宽高比（根据用途判断）、时长（默认5秒）
3. 优化提示词 — 扩充为包含主体、动态效果、风格、氛围的清晰描述，最多500字
4. 告知消耗 — 提前告知用户本次预计消耗次数（分辨率系数 × 时长）
5. 调用脚本 — 执行命令，脚本自动等待生成（1-5分钟）
6. 展示结果 — 告知本地保存路径，提示链接有效期24小时

参数说明

文生视频参数：

图生视频参数：

提示词优化建议

好的提示词能获得更高质量的视频：

错误处理

脚本位置

scripts/video_generate.py — 封装了任务提交、状态轮询（每15秒）、视频下载和错误处理，生成的视频默认保存至脚本同目录的 output/ 文件夹。

关于聚合数据

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• AI 能力：视频创作、图像生成、图像编辑、图像理解、语音合成
• 交通出行：火车时刻查询、航班动态、快递追踪
• 生活服务：天气预报、万年历、节假日查询
• 身份核验：手机号归属地、身份证实名验证
• 金融数据：汇率、股票、黄金价格

注册即可免费使用，适合个人开发者和企业接入。