用途
Arcads AI Video Marketing Skill 用于通过 Arcads 外部 API 生成 AI 营销视频和静态图片广告，覆盖从视频到图片的完整创意生产链路。它作为 Claude Code Skills 合集的一部分，由 ara.so 提供。
支持的模型
视频模型包括：Seedance 2.0（旗舰视频模型）、Sora 2、Veo 3.1、Kling 3.0、Grok Video、OmniHuman，以及音频驱动视频生成。
图像模型包括：Nano Banana 2/Pro/Edit、ChatGPT Image 2。
此外还提供 37 个模板的 Meta 图片广告库，以及用于 Pixar 风格和黏土动画广告的多步骤流水线。
安装方式
第一步，克隆仓库：
git clone https://github.com/krusemediallc/arcads-claude-code.git
cd arcads-claude-code
第二步，运行 setup 脚本：
./scripts/setup.sh
该脚本会要求输入 Arcads API 密钥（可在 app.arcads.ai/settings/api 获取），创建存放凭据的 .env 文件，验证 API 连接，并生成 MASTER_CONTEXT.md 工作区文件。
第三步，安装多步骤流水线所需的可选依赖：
# macOS
brew install ffmpeg jq node
# Linux
apt install ffmpeg jq nodejs python3
# 特定工作流所需的 Python 包
pip install openai-whisper # 用于字幕转录
pip install -r shared/skills/meta-ad-builder/scripts/requirements.txt # 用于 Meta API 发布
核心 API 结构
所有 API 调用均通过 Arcads 基础 URL 发出，API 密钥存放在 .env 中：
ARCADS_API_KEY=your_api_key_here
基础请求模式（Python）为：设置 Authorization 为 Bearer 形式的 API 密钥，提交生成请求后获取 jobId，然后轮询任务状态直到 completed 或 failed。示例中 base_url 为 https://api.arcads.ai。
视频生成模型
Seedance 2.0（旗舰模型）
端点包括：POST /v1/seedance-2/video（文生视频或图生视频，4-15 秒）、POST /v1/seedance-2/video-to-video（视频到视频转换）。
关键参数包括：prompt（字符串，必填，场景描述）、duration（整数，4-15，视频长度秒数）、aspectRatio（字符串，支持 "16:9"、"9:16"、"1:1"、"4:5"）、startFrame（可选，base64 图像作为起始帧）、referenceImages（可选，最多 3 张 base64 参考图）、dialogue（可选，内嵌语音）、shotStyle（可选，"static"、"dynamic"、"cinematic"）。
文档给出的示例包括：UGC 自拍风格产品评测、无人物出镜的高端产品展示、使用参考图的图生视频。
Sora 2（长时文生视频）
端点：POST /v1/sora2/video。参数包括 prompt（必填）、duration（整数，4-20，最长 20 秒）、aspectRatio、referenceImages（可选，风格参考）。用于较长时长的叙事视频。
Veo 3.1（起始帧动画）
端点：POST /v1/veo3/video。最适合将静态 UGC 图片动画化为带对话的视频。参数包括 startFrame、dialogue、duration、aspectRatio、prompt。
Kling 3.0（B-roll 与场景）
端点包括：POST /v1/b-roll（快速环境片段）、POST /v1/scene（叙事场景生成）。示例 B-roll 提示词覆盖咖啡、手部打字、产品等场景。
Grok Video
端点：POST /v2/videos/generate，payload 中 model 字段为 "grok-video"，附带 prompt、duration、aspectRatio。
图像生成
Nano Banana（角色一致性图像）
端点包括：POST /v1/nano-banana-2（默认模型）、POST /v1/nano-banana（Pro 版本，Gemini 3，更紧的身份锁定）、POST /v1/nano-banana-edit（局部重绘）。
参数包括：prompt（必填）、aspectRatio、referenceImages（最多 5 张，用于角色一致性）、refImageAsBase64（可选，基础参考图）。
示例包括：生成 AI 网红角色表（先用 hero 肖像，再以其为参考生成 9 个附加角度）、生成带产品的 UGC 自拍静图（结合人物参考、产品参考和 UGC 美学参考）。
ChatGPT Image 2（排版与 UI 为主）
端点：POST /v1/chatgpt-image-2。最适合 UI mockup、文字密集型广告、截图。参数为 prompt 与 aspectRatio。
静态 Meta 图片广告库（37 个模板）
仓库包含三个专用技能：chatgpt-image-ad（排版/UI 密集型模板）、nano-banana-image-ad（照片写实/生活化模板）、image-ad-clone（将现有广告逆向工程为模板）。
模板类别包括：UI mockup（Apple Notes、Slack、iMessage、ChatGPT 对话）、编辑风（Forbes hero、杂志封面、报纸）、对比表、仿 Google 搜索结果、便利贴平铺、广告牌/户外、博物馆展陈、天气预报 UI、刮刮卡、创始人信、约会应用卡片，以及另外 25 类以上。
文档给出的示例包括 Apple Notes 清单风格广告，以及对比表广告。
克隆现有广告的工作流：用户提供参考图路径，Agent 分析构图、文字、风格，生成可复用提示词模板，在合适的后端（chatgpt-image-2 或 nano-banana-2）上测试，用户验证输出，模板保存到 shared/skills/image-ad-prompting/templates/。
任务轮询与状态
端点：GET /v1/jobs/{jobId}。状态包括：pending（任务已排队）、processing（生成中）、completed（素材就绪）、failed（发生错误）。文档提供 poll_and_download 函数用于轮询直到完成并下载结果。
限制
资料未说明具体的定价、收费方式、速率限制与配额。文档中出现的模板数量（37 个）与依赖项为技能本身声明的内容。使用前需要自行获取 Arcads API 密钥。