{"id":51112791,"url":"https://github.com/frank-oll/ai-video-creator","last_synced_at":"2026-06-24T19:01:09.130Z","repository":{"id":364005993,"uuid":"1265848032","full_name":"Frank-oll/ai-video-creator","owner":"Frank-oll","description":"Claude skill: 把一个生活妙招选题端到端做成可直接发布的竖屏 AI 短视频(自带 AI 配音)。双锚定一致性 + 全中文分镜 + 火山 ARK 单网关。End-to-end AI short-video skill with native voiceover.","archived":false,"fork":false,"pushed_at":"2026-06-11T09:05:55.000Z","size":77,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T09:24:34.692Z","etag":null,"topics":["agent-skill","ai-video","ai-voiceover","anthropic","claude","claude-skill","doubao","douyin","ffmpeg","image-to-video","seedance","seedream","short-video","text-to-video","volcengine","xiaohongshu"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Frank-oll.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T06:06:29.000Z","updated_at":"2026-06-11T09:06:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Frank-oll/ai-video-creator","commit_stats":null,"previous_names":["frank-oll/ai-video-creator"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Frank-oll/ai-video-creator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frank-oll%2Fai-video-creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frank-oll%2Fai-video-creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frank-oll%2Fai-video-creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frank-oll%2Fai-video-creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Frank-oll","download_url":"https://codeload.github.com/Frank-oll/ai-video-creator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frank-oll%2Fai-video-creator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34745456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-24T02:00:07.484Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skill","ai-video","ai-voiceover","anthropic","claude","claude-skill","doubao","douyin","ffmpeg","image-to-video","seedance","seedream","short-video","text-to-video","volcengine","xiaohongshu"],"created_at":"2026-06-24T19:01:08.360Z","updated_at":"2026-06-24T19:01:09.112Z","avatar_url":"https://github.com/Frank-oll.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI 短视频skill · ai-video-creator\n\n\u003e 一个 [Claude Agent Skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview) —— 把一个生活妙招选题,端到端做成**可直接发布的竖屏 AI 短视频(自带 AI 配音)**。\n\n[![下载 .skill](https://img.shields.io/github/v/release/Frank-oll/ai-video-creator?label=下载%20.skill\u0026color=blueviolet)](https://github.com/Frank-oll/ai-video-creator/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)\n![Platform](https://img.shields.io/badge/平台-抖音%20%7C%20小红书%20%7C%20视频号-ff2c55.svg)\n![Gateway](https://img.shields.io/badge/单网关-火山引擎%20ARK-orange.svg)\n\n**English:** An end-to-end Claude skill that turns one \"life-hack\" idea into a publish-ready 9:16 short\nvideo — consistent storyboard images → image-to-video clips with **native AI voiceover** → auto-stitched\nfinal cut. Single gateway (Volcengine ARK), single key. All generation prompts are in Chinese by design\n(Seedream / Seedance are ByteDance models tuned for Chinese semantics).\n\n\n## 它做什么\n\n```\n问方向 → 热门检索/对标视频拆解 → 选题对齐 → 双锚定方案(视觉+叙事) → 分镜脚本\n→ 生成 N 张一致性分镜静图(火山 Doubao-Seedream-5.0-lite)\n→ 并发生成 N 段 I2V 视频,带原生 AI 配音(火山 Doubao-Seedance-1.5-pro)\n→ ffmpeg 自动拼接成片\n```\n\n默认结构 **3 镜 × 5 秒 = 15 秒,9:16 竖屏**(可调)。最终交付:\n\n- **`final.mp4`** — 成片,自带 AI 配音,可直接发布\n- 分镜静图(PNG)+ 分段视频(MP4,各自带配音,供剪映精修)\n- `storyboard.xlsx` 分镜表 + `voiceover-script.txt` 口播稿 + 后期指引\n\n## 三档确认模式\n\n| 模式 | 说法示例 | 体验 |\n|------|---------|------|\n| 标准(默认) | — | 选题/锚定/分镜/成本/基准图逐步确认,适合首次或新方向 |\n| 快速 | \"快速来一条\"\"老规矩\" | 一份完整方案一次确认 + 成本确认,两次交互出片 |\n| 托管 | \"直接做完给我\" | 只确认成本,做完交付并汇报所有决策 |\n\n偏好(方向/人群/音色/模式)会被记住,第二次使用一句话带过。\n\n## 架构:单 key + 火山纯生态\n\n| 用途 | 网关 | 默认模型 |\n|------|------|------|\n| 图片生成 | 火山引擎 ARK | `doubao-seedream-5-0-lite` |\n| 视频生成 + 配音 | 火山引擎 ARK | `doubao-seedance-1-5-pro-251215` |\n| 拼接成片 | 本地 ffmpeg | concat + stream copy(失败自动重编码) |\n\n只要一个 `ark-` 开头的 key。模型可用 `--model` 热替换(换 Seedance 1.0 系列更便宜但\n**无音频**;成本估算会按实际模型单价算)。\n\n## 安装\n\n### 1. 获取 skill\n\n**方式 A · git clone(推荐,方便 `git pull` 更新):**\n\n```bash\ngit clone https://github.com/Frank-oll/ai-video-creator.git\n```\n\n把整个目录放进你的 agent 的 skills 目录:\n\n- **Claude Code**:放到 `~/.claude/skills/ai-video-creator/`(目录里直接是 `SKILL.md`)\n- **claude.ai**:Settings → Skills → Upload(先把目录打包成 `.skill` / zip 再上传)\n- 其他遵循 SKILL.md 规范的 agent(Kimi 等):放进各自的 skills 目录\n\n**方式 B · 下载 [`.skill` / `.zip` 包](https://github.com/Frank-oll/ai-video-creator/releases/latest)**(在 Release 页),直接上传到 claude.ai(Settings → Skills → Upload)。\n\n### 2. 安装依赖\n\n```bash\npip install -r requirements.txt      # requests + openpyxl\n# ffmpeg(拼接/抽帧用,强烈推荐):\nbrew install ffmpeg          # macOS\nsudo apt install ffmpeg      # Ubuntu/Debian\n# Windows: https://www.gyan.dev/ffmpeg/builds/ 下载,bin 加 PATH\n```\n\n### 3. 配置火山 ARK key\n\n注册 https://www.volcengine.com/ 并实名 → 进方舟控制台 https://console.volcengine.com/ark →\n「模型管理」免费开通 **Doubao-Seedream-5.0-Lite** 和 **Doubao-Seedance-1.5-Pro** →\n「API Key 管理」新建 key(以 `ark-` 开头)。余额建议 ≥ ¥10。\n\n## 支持的智能体(跨平台)\n\n本 skill 遵循通用的 **SKILL.md / Agent Skill 规范**,不绑定单一客户端。除了 Claude Code、\nclaude.ai,理论上也能放进其他兼容该规范的智能体使用,例如 **WorkBuddy、Marvis、OpenClaw、\nHermes** 等。\n\n\u003e ⚠️ **使用效果因模型而异**:本 skill 重度依赖宿主智能体的底层模型能力——多模态自检(看图判断\n\u003e 画面一致性)、中文语义理解、命令行/工具调用、长流程编排。不同智能体接入的模型不同,**出片\n\u003e 质量与稳定性会有差异**;能力较弱的模型可能需要更多人工确认或重试。建议优先选用多模态和中文\n\u003e 能力较强的模型,以获得最佳效果。\n\n## 首次使用\n\n在 chat 里说:**\"做一条妙招短视频\"**(或直接说方向:\"做一条阳台种菜的短视频\")。\n\nagent 会:索要并验证 key(配置时就把模型开通问题预检出来)→ 问方向 → 检索热门/拆解你给的\n对标 → 出选题和方案 → 确认成本(默认配置约 $0.27 ≈ ¥2)→ 生成(每张图、每段视频 agent\n先自检再交付)→ 拼接成片。\n\n## 成本与耗时(默认 3 镜 × 5s)\n\n| 项目 | 估算 |\n|------|------|\n| Seedream 生图 × 3 | ~$0.06 |\n| Seedance 1.5 pro(含配音)15s | ~$0.21 |\n| 合计 | **~$0.27 ≈ ¥2**(自检重试可能 +0~2 次生图) |\n\n视频 3 镜并发生成约 1-4 分钟。真实单价以火山控制台账单为准。\n\n## 文件结构\n\n```\nai-video-creator/                   # 仓库根 = skill 根(SKILL.md 里 name: ai-video-sannong)\n├── SKILL.md                        # 工作流主干(给 agent 读)\n├── README.md                       # 本文件(给人读)\n├── LICENSE                         # MIT\n├── requirements.txt                # Python 依赖\n├── scripts/api_client.py           # 全部 API 调用封装(火山 ARK + ffmpeg)\n├── profiles/                       # 题材包(可扩展)\n│   ├── _template.md                #   新题材现场生成模板\n│   ├── sannong.md                  #   三农园艺\n│   └── home-hacks.md               #   家居清洁收纳\n├── references/                     # 按需查阅\n│   ├── voice-presets.md            #   配音音色详解(6 preset + 方言)\n│   ├── troubleshooting.md          #   故障排查\n│   └── post-editing-guide.md       #   剪映后期指引模板\n├── templates/sample_visual_anchor.md   # 双锚定 + prompt 完整范例\n└── examples/case_gemini_analysis.md    # 对标拆解报告范例\n```\n\n生成的项目落在 `output/\u003c日期-选题\u003e/`,每条视频独立目录,含 `project.json` 状态档案\n(支持断点续传、单镜重做)。\n\n## 常见问题\n\n- **模型未开通?** 不是 bug,火山要求控制台手动点「开通」(免费)。配置阶段的预检会直接\n  告诉你差哪个。详见 `references/troubleshooting.md`。\n- **配音能换吗?** 6 个内置 preset(含男声)+ 方言 + 完全自定义,见\n  `references/voice-presets.md`。\n- **想做新题材?** 直接说,agent 会现场生成题材包并可保存复用(`profiles/_template.md`)。\n- **想要更便宜?** `--model doubao-seedance-1-0-pro-fast-251015`(省 ~40%,无配音,\n  剪映\"文本朗读\"补)。\n- **没装 ffmpeg?** 不阻断,拿 3 段分段 mp4 去剪映手动拼。\n- **修改 skill 后**:重新 zip 成 `.skill` 重传 claude.ai(改动不自动同步)。\n\n## 限制\n\n- 不支持人物对话/表演类视频(跨镜身份一致性受限;末镜露脸+CTA 可选但有翻车率)\n- 不支持复杂多步骤工艺(镜头数有限)、背景频繁切换的视频\n- AI 配音支持中文(普通话 + 四川/粤语等方言)、英文、日韩西语,小语种不支持\n\n## 贡献\n\n欢迎 PR 和 Issue,尤其是这几类:\n\n- **新题材包**:照 `profiles/_template.md` 写一个新 `profiles/\u003c拼音slug\u003e.md`(美食、宠物、\n  育儿、手工……),让更多垂类开箱即用。记得认真填「安全红线」字段。\n- **音色 preset**:在 `scripts/api_client.py` 的 `VOICE_PRESETS` 里加新音色,并在\n  `references/voice-presets.md` 补说明。\n- **对标拆解 / 双锚定范例**:好的范例能显著提升新手出片质量,参考 `examples/`、`templates/`。\n- **Bug、prompt 翻车 case、新模型适配**:开 Issue 时尽量贴上选题、报错原文和 `project.json`。\n\n提交前请确认**没有把任何 API key、`output/` 产物、本地配置**带进 commit(`.gitignore` 已覆盖常见情况)。\n\n## 免责声明\n\n- **第三方服务**:本 skill 调用火山引擎 ARK(Doubao Seedream / Seedance)生成图片与视频,\n  产生的费用、内容合规与服务可用性由火山引擎及使用者自行负责,本项目不收取任何费用。\n- **成本仅为估算**:README 与 `estimate-cost` 给出的金额是基于公开报价的估算,**真实账单以\n  火山控制台为准**。\n- **AI 生成内容**:成片为 AI 生成,发布到各平台时请遵守平台关于「AI 生成内容」的标识要求与\n  内容规范;请勿用于生成误导性、违法或侵权内容。\n- 本软件按「现状」提供,不附带任何担保,详见 [LICENSE](LICENSE)。\n\n## 许可证\n\n[MIT](LICENSE) © 2026 Frank\n\n---\n\n🎬 觉得有用的话,点个 ⭐ Star 支持一下,也欢迎把你做出来的成片来交流。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrank-oll%2Fai-video-creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrank-oll%2Fai-video-creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrank-oll%2Fai-video-creator/lists"}