auto-video-creator

通过XLXAI Sora2 API实现文本或图像转视频，支持多种分辨率与时长。

已扫描

项目

内容

适合谁

短视频创作者、营销推广人员

不适合谁

无网络环境用户、需要直接发布到社交平台的用户

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @yefl2064/auto-video-creator

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

自动视频生成器 - XLXAI 视频生成技能

使用 XLXAI Sora2 API 从文本提示或图像生成专业视频。

范围

此技能仅专注于视频生成：

✅ 调用 XLXAI Sora2 API 生成视频
✅ 完成后返回包含视频链接的任务/结果 JSON
✅ 支持文本到视频和图像到视频生成
❌ 不上传、发布或代理视频至 TikTok 等平台
❌ 不处理社交媒体发布功能

如需上传或发布功能，请使用独立技能（例如 post-to-tiktok-getlate）或下游工作流。

快速开始

1. 设置环境

cp skills/xlxai-video/.env.example skills/xlxai-video/.env
# 编辑 skills/xlxai-video/.env 并设置 XLXAI_API_KEY
export XLXAI_API_KEY="$YOUR_KEY"

2. 生成视频

python3 skills/xlxai-video/scripts/generate_video.py "您的视频提示内容" --model sora2-portrait-4s

该脚本从 XLXAI_API_KEY 环境变量加载 API 密钥，处理任务创建与轮询，并在完成后返回包含视频链接的 JSON。

API 响应示例

任务创建响应（非等待模式）

{
  "task_id": "task_Ue8FsGswnj3fCaY91yAj84m8AA8lLVpm",
  "status": "pending",
  "model": "sora2-portrait-4s",
  "created_at": "2026-03-03T18:19:30Z"
}

完成的任务响应

{
  "task_id": "task_Ue8FsGswnj3fCaY91yAj84m8AA8lLVpm",
  "status": "completed",
  "video_url": "https://api.xlxai.store/video2-proxy/base/video/79193b56b4792daec07c5564bff412f193a6c20e5ee7ca0a323ab753da2420a9.mp4",
  "progress": 100,
  "duration": 38,
  "message": "Generation complete",
  "created_at": "2026-03-03T18:19:30Z",
  "completed_at": "2026-03-03T18:20:08Z"
}

注意：

字段名称取决于 XLXAI API 版本；请检查原始 JSON 获取实际字段
video_url 可能指向第三方 CDN；如需自托管，请下载并自行部署

视频模型

根据需求选择合适的模型：

竖屏模型（垂直视频）

sora2-portrait-4s — 4 秒竖屏视频（默认）
sora2-portrait-8s — 8 秒竖屏视频
sora2-portrait-12s — 12 秒竖屏视频

横屏模型（水平视频）

sora2-landscape-4s — 4 秒横屏视频
sora2-landscape-8s — 8 秒横屏视频
sora2-landscape-12s — 12 秒横屏视频

默认值： sora2-portrait-4s

使用模式

文本到视频生成

通过文本描述生成视频：

python3 scripts/generate_video.py "一位30岁的美国男性穿着西装面向镜头演讲" \
  --model sora2-landscape-8s

图像到视频生成

从图像生成带动态效果的视频（本地图像会自动转换为 data URI）：

python3 scripts/generate_video.py "男士展示西装，表示其做工精良且价格实惠" \
  --model sora2-portrait-4s \
  --image "/path/to/local/image.jpg"

或直接使用图像 URL：

python3 scripts/generate_video.py "男士展示西装，表示其做工精良且价格实惠" \
  --model sora2-portrait-4s \
  --image "http://example.com/image.jpg"

非阻塞任务创建

立即获取任务 ID，不等待完成：

python3 scripts/generate_video.py "您的提示内容" --no-wait

稍后检查状态：

python3 scripts/generate_video.py --check-status task_abc123

脚本选项

选项	说明	默认值
`--model`	视频模型（竖屏/横屏，4秒/8秒/12秒）	sora2-portrait-4s
`--image`	图像 URL 或本地文件路径	—
`--no-wait`	立即返回任务 ID	false
`--poll-interval`	状态检查间隔（秒）	10
`--timeout`	最大等待时间（秒）	600
`--check-status`	检查已有任务的状态	—

输出格式

成功时，脚本返回包含以下字段的 JSON：

status: "completed"
video_url: 生成视频的下载链接
progress: 100
duration: 生成耗时（秒）
task_id: 唯一任务标识符
created_at: 任务创建时间戳
completed_at: 任务完成时间戳

错误处理

脚本支持：

✅ API 请求失败时重试逻辑
✅ 超时时间最长 600 秒（可配置）
✅ 生成过程中的进度报告
✅ 失败任务的清晰错误提示
✅ HTTP 状态码验证

重要注意事项

版权与权利：发布生成内容前，请确认版权及肖像权合规
API 密钥安全：请妥善保管 API 密钥；生产环境中使用环境变量
视频链接：可能指向第三方 CDN；如需自托管，请下载后自行部署
速率限制：请查阅 XLXAI API 文档了解速率限制详情

日语指南

设置

cp skills/xlxai-video/.env.example skills/xlxai-video/.env
export XLXAI_API_KEY="$YOUR_KEY"

视频生成

python3 skills/xlxai-video/scripts/generate_video.py "あなたのプロンプト" --model sora2-portrait-4s

画像からビデオを生成

python3 skills/xlxai-video/scripts/generate_video.py "シーンの説明" --image "/path/to/image.jpg"

韩语指南

설정

cp skills/xlxai-video/.env.example skills/xlxai-video/.env
export XLXAI_API_KEY="$YOUR_KEY"

비디오 생성

python3 skills/xlxai-video/scripts/generate_video.py "당신의 프롬프트" --model sora2-portrait-4s

이미지에서 비디오 생성

python3 skills/xlxai-video/scripts/generate_video.py "장면 설명" --image "/path/to/image.jpg"

联系方式

邮箱: yefl2064@gmail.com
Telegram: [@kuajintontu](https://t.me/kuajintontu)

@yefl2064

已收录 1 个 Skill