用途
arcads-claude-code 是一个基于 Python 的智能体技能包，面向 AI 编程智能体（如 Claude Code、Cursor），通过自然语言命令以编程方式访问完整的 Arcads 创意栈，用于生成 AI 营销视频和图片。它让智能体能够自主地完成从提示词设计、任务提交、轮询结果到文件下载和广告发布的流程。
主要能力
视频模型
- Seedance 2.0（旗舰）：适合 UGC 内容、产品展示、功能演示，支持 4–15 秒带原生音频的片段。
- Veo 3.1：起始帧动画，将静图动画化并可嵌入对白；文档强调生成前必须显式确认对白。
- Sora 2：文生视频，最长约 20 秒，适合较长场景和电影感定场镜头；支持视频 remix 重风格化。
- Kling 3.0：用于 B-roll 和场景生成，5–10 秒片段。
- 其他：Grok Video、OmniHuman（说话头像）、音频驱动唇同步。
图像模型
- Nano Banana 2、Nano Banana（Pro，Gemini 3 Pro Image）、Nano Banana Edit（修补/编辑）
- ChatGPT Image 2：适合文字密集、UI 模拟、截图风格广告
- 支持参考图实现角色一致性，并提供了 10 图 AI 网红角色设定表工作流
37 个静态 Meta 图文广告模板 分为三类：ChatGPT Image 2 模板（Apple Notes 列表、Forbes 编辑风、伪 Google 搜索、对比表、便签平铺、Slack 线程、ChatGPT 对话、iMessage 截图、杂志封面、广告牌、天气预报 UI、刮刮卡等）；Nano Banana 模板（桌面产品特写、手持产品、浴室台面、厨房场景、办公桌、车内、健身房等）；跨兼容模板（前后对比、创始人信、约会应用卡片、博物馆展品等）。
多步骤流水线 包括 Pixar 风格广告、黏土动画广告、YouTube 缩略图等，流程包含角色锁定、分镜、逐镜头图生视频、ffmpeg 拼接与字幕烧录。
智能体原生工作流 轮询任务状态、成本门禁、提示词工程、文件组织；图片广告生成器支持 chatgpt-image-ad（仅标准库）、nano-banana-image-ad（写实）和 image-ad-clone（逆向现有广告）。可经 Meta Marketing API 发布广告，默认创建为暂停状态以供审核。
使用方式
- 克隆并初始化：
git clone https://github.com/krusemediallc/arcads-claude-code.git
cd arcads-claude-code
./scripts/setup.sh
setup 脚本会提示输入 Arcads API Key（来自 app.arcads.ai/settings/api），创建 .env 写入 ARCADS_API_KEY，验证连接并生成 MASTER_CONTEXT.md。
- 安装核心依赖：
python3 -m pip install requests python-dotenv
可选依赖：ffmpeg、jq（视频拼接及 Pixar/黏土工作流）、node 与 openai-whisper（字幕烧录）、Meta 广告发布依赖（requirements.txt）。
- 环境变量：在项目根目录
.env中设置。
ARCADS_API_KEY=your_api_key_here
- 基本 API 流程：以
https://api.arcads.ai为 BASE_URL，使用 Bearer 认证。典型流程为提交生成请求、轮询状态、下载结果；文档给出了 generate_video、poll_video、download_video 等示例函数，以及图像广告生成器的命令行调用示例。
适用场景
适合 AI 编程智能体自动化生成营销创意素材，包括 UGC 视频、产品展示、B-roll、定场镜头、说话头像、唇同步、写实图片、UI 风格图文广告，以及 Pixar/黏土动画等多步骤广告流水线；也可用于批量复用 37 个 Meta 广告模板并发布到 Meta Marketing API。
限制
（原文在此处中断，后续内容暂未提供）已有的明确限制包括：Veo 3.1 生成前必须显式确认对白；Meta 广告默认以暂停状态创建以便审核；部分流水线需要额外安装 ffmpeg、jq、node、openai-whisper 等依赖。其他关于收费、价格、平台或效果的信息暂未提供。