AI视频创作#

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

支持两种视频创作模式：

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

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

---

前置配置：获取 API Key#

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

bash

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

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

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

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

---

使用方法#

文生视频（基础）#

bash

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

输出示例：

text

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

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

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

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

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

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

bash

# 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

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

档位系数说明480P（默认）1次/秒最省次数，适合快速预览720P2次/秒高清，适合社交平台1080P3次/秒超清，适合正式场合

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

比例适用场景备注16:9（默认）横屏视频、桌面展示9:16竖屏短视频（抖音/快手/视频号）1:1方形社交媒体4:3传统横屏480P 不支持3:4传统竖屏480P 不支持

可用时长：

时长说明5秒（默认）最省次数10秒中等时长15秒最长， 480P 不支持

计费公式：次数消耗 = 分辨率系数 × 时长（秒） 例如：1080P × 10秒 = 3 × 10 = 30次

添加反向提示词#

bash

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

关闭提示词智能改写#

bash

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

图生视频#

bash

# 图片 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。

指定输出目录#

bash

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

仅获取链接（不下载）#

bash

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

查询已提交任务#

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

bash

python scripts/video_generate.py --query JH819251208164211x1hC5

---

AI 使用指南#

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

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

参数说明#

文生视频参数：

参数必填默认值说明提示词（位置参数）是—视频内容描述，最多500字--resolution否480P分辨率：480P / 720P / 1080P--proportion否16:9宽高比：16:9 / 9:16 / 1:1 / 4:3 / 3:4--duration否5视频时长（秒）：5 / 10 / 15--negative否—反向提示词，最多300字--no-extend否—关闭提示词智能改写--output否output/视频保存目录--no-download否—只返回链接，不下载--key否—临时传入 API Key

图生视频参数：

参数必填默认值说明--image是—首帧图片 URL 或 Base64 编码--prompt是—运动描述，最多500字--resolution否480P分辨率：480P / 720P / 1080P--duration否5视频时长（秒）：5 / 10 / 15--negative否—反向提示词，最多300字--audio否—配音文件 URL（wav/mp3，3-30秒）--no-extend否—关闭提示词智能改写

提示词优化建议#

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

要素示例主体动态海浪拍打礁石、城市车流光轨、花朵慢慢绽放风格写实摄影风、电影感、慢动作、延时摄影、动漫风镜头运动缓慢推进、由远及近、俯视旋转、平滑横移色彩/光线黄金时刻暖光、蓝调夜景、自然漫射光场景氛围宁静祥和、壮观震撼、浪漫唯美、科技感十足

错误处理#

情况处理方式error_code 10001/10002API Key 无效或无权限，引导用户至 聚合数据 重新申请error_code 10012今日调用次数已用尽，建议升级套餐error_code 282701参数错误，检查分辨率/宽高比/时长组合是否合法，或图片链接是否可访问error_code 282702订单不存在，确认 orderid 是否正确error_code 282703/704/705服务端异常，稍后重试480P + 15秒不支持此组合，建议改为 720P 或缩短时长480P + 4:3/3:4不支持此宽高比，建议改用其他比例或升级分辨率状态 FAILED生成失败，建议修改提示词后重试等待超时（>360s）使用 --query <orderid> 稍后查询结果图片链接无法访问确保 URL 为公网可访问，不支持本地路径视频下载失败手动访问 videourl 链接保存视频（24小时内有效）

---

脚本位置#

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

---

关于聚合数据#

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

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

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