SuperAPI AI 工具集

arcads-claude-code

营销与增长

查看项目

更新于 10-16 12:51

技能介绍

用途

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 缩略图、字幕工作流。

使用方式

安装

  1. 克隆并设置:
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 工作区文件。

  1. 安装依赖(可选,视工作流而定): 基础视频/图片生成仅需 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
  1. 环境变量: .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)对白需单独确认。
  • 具体价格、平台支持范围与效果未在资料中提供。