用途
arcads-claude-code 是一个面向 Claude Code 与 Cursor 等 AI 智能体的技能包,用于通过 Arcads API 生成 AI 营销视频与图片。它覆盖 Arcads 的完整创意工具链,帮助智能体完成 API 调用、任务轮询、提示词工程、文件组织与成本确认。
主要能力
视频模型
- Seedance 2.0:旗舰模型,支持 4–15 秒片段、原生音频、图生视频、视频生视频、参考图与多种镜头风格。
- Sora 2:文生视频,最长 20 秒,支持参考图与视频重混(remix)。
- Veo 3.1:主要用于起始帧动画,可将静态 UGC 图片动画化并加入自然运动与对白。
- Kling 3.0:用于 b-roll 与场景生成。
- Grok Video:视频生成。
- OmniHuman:生成说话头像。
- Audio-driven:将视频与音频文件进行唇形同步。
图片模型
- Nano Banana 2(默认)、Nano Banana Pro(更严格的身份锁定)、Nano Banana Edit(局部重绘)。
- ChatGPT Image 2:适合排版与 UI 模仿类图片。
静态广告库
- 37 个经过验证的 Meta 图片广告模板。
- 决策树:排版/UI 模仿类使用 chatgpt-image-ad;照片写实/生活方式/多参考图使用 nano-banana-image-ad;逆向工程现有广告使用 image-ad-clone。
多步骤流水线
- Pixar 风格动画广告、黏土动画广告、YouTube 缩略图、字幕工作流。
使用方式
安装
- 克隆并设置:
git clone https://github.com/krusemediallc/arcads-claude-code.git
cd arcads-claude-code
./scripts/setup.sh
setup 脚本会提示输入 Arcads API 密钥(获取地址:https://app.arcads.ai/settings/api),保存到 .env(不会提交),验证 API 连接,并创建 MASTER_CONTEXT.md 工作区文件。
- 安装依赖(可选,视工作流而定): 基础视频/图片生成仅需 Python 3.10+。多步骤流水线需要:
# macOS
brew install ffmpeg jq node
# Python 包(特定工作流)
pip install openai-whisper # 字幕转录
pip install -r shared/skills/meta-ad-builder/scripts/requirements.txt # Meta 发布
Linux:
apt install ffmpeg jq nodejs python3 python3-pip
- 环境变量:
.env文件结构:
ARCADS_API_KEY=your_api_key_here
切勿硬编码密钥,始终使用 os.environ['ARCADS_API_KEY']。
核心 API 模式
- 认证:所有请求需要
Authorization: Bearer $ARCADS_API_KEY头。 - 轮询工作流:大多数视频/图片生成是异步的:POST 到生成端点获得
jobId;轮询 GET/v1/job/{jobId}直到status: "completed";提取outputUrl或imageUrl。
视频生成示例
- Seedance 2.0 文生视频(含对白)、图生视频(产品揭示)。
- Sora 2 文生视频与视频重混。
- Veo 3.1 起始帧动画(对白需单独确认,存在强制对白门控)。
- Kling 3.0 b-roll 与场景生成。
- Grok Video、OmniHuman、Audio-driven 生成。
图片生成示例
- Nano Banana 基础生成、带参考图生成(角色一致性)、创建 AI 网红(10 图角色表)、UGC 产品自拍。
- ChatGPT Image 2 生成。
静态 Meta 图片广告
- 从模板库生成,如 Apple Notes 模板、Forbes 编辑风格模板。
- 将现有广告克隆为模板:视觉分析、模板构建、测试生成。需先阅读
shared/skills/image-ad-prompting/OVERVIEW.md了解完整工作流与宽高比兼容矩阵。
多步骤流水线
- Pixar 风格 3D 动画广告:需要
ffmpeg、jq、npx hyperframes、whisper,可通过 bash 编排./shared/skills/pixar-style-ad/scripts/generate.sh,或使用 Python 工作流。
适用场景
- 为营销活动批量生成 AI 视频与图片广告。
- 创建 AI 网红角色与 UGC 风格内容。
- 基于模板库快速产出 Meta 静态图片广告。
- 将现有广告逆向工程为可复用模板。
- 制作 Pixar 风格动画广告、黏土动画广告、YouTube 缩略图与字幕。
限制
- 需要 Arcads API 密钥,且 API 调用可能产生费用(成本确认由智能体处理)。
- 基础生成需 Python 3.10+;多步骤流水线需额外安装 ffmpeg、jq、node、whisper 等依赖。
- 部分模型(如 Veo 3.1)对白需单独确认。
- 具体价格、平台支持范围与效果未在资料中提供。