SuperAPI AI 工具集

arcads-video-agent

营销与增长

查看项目

更新于 10-16 10:35

技能介绍

用途

Arcads Video Agent 是一个智能体技能包(Skill),用于在 Claude Code 或 Cursor 中,通过 Arcads 账户生成 AI 营销视频与图像。其核心目标是把自然语言需求转换为可直接用于投放的视频与图片广告素材。

主要能力

视频生成

  • UGC 自拍风格短视频、产品揭示、B-roll、场景动画,时长约 4-20 秒。
  • 支持模型/能力包括:Seedance 2.0(旗舰视频)、Sora 2、Veo 3.1、Kling 3.0、Grok Video、OmniHuman、Audio-driven 等。
  • Veo 3.1 支持以起始帧(startFrame)驱动图生视频,并可嵌入对话(dialogue 为含语音时的必填项)。
  • Sora 2 支持文本生视频,时长上限约 20 秒,文档称会按脚本词数(约每秒 2.5 词)自动选择时长。

图像生成

  • 支持 Nano Banana 2 / Pro / Edit、ChatGPT Image 2 等模型。
  • Nano Banana 模型选择:nano-banana-2(默认,质量与速度均衡)、nano-banana(Pro,Gemini 3 Pro Image,更高保真)、nano-banana-edit(修复/编辑工作流)。
  • 可生成 AI 网红角色设定表(先出英雄正面肖像,再以其为参考生成 9 个角度,共 10 张图)。
  • 可生成 UGC 产品自拍静图,组合角色参考、产品参考与 UGC 美学参考(最多 5 张参考图),并强调皮肤质感与相机瑕疵等真实感细节。

静态 Meta 图片广告模板库

  • 内置 37 个经过验证的 Meta 图片广告模板,示例类型包括 Apple Notes 清单、Forbes 编辑风格、对比表格、仿 UI 截图等。
  • ChatGPT Image 2 适合排版/UI 仿制类广告;Nano Banana 2 适合拟真/生活方式类广告。
  • 提供图片广告克隆流程:先由视觉模型分析现有广告并提取模板结构(template_type、推荐后端、元素、宽高比等),再据此生成新版本,可选与另一后端交叉验证。

多步动画流水线

  • 支持皮克斯风格 3D 动画广告、黏土动画广告、字幕烧录(caption burn-in)工作流。
  • 提供 API 编排能力:自动轮询任务状态、费用确认、文件整理、提示词工程。

使用方式

环境要求

  • 必需:python3,版本需为 3.10+。
  • 可选依赖(仅使用特定工作流时安装):
    • brew install ffmpeg(Pixar/黏土/字幕工作流)
    • brew install jq(bash 流水线脚本)
    • brew install node(字幕烧录 hyperframes)
    • pip install openai-whisper(转写)

安装与配置

# 克隆仓库
git clone https://github.com/krusemediallc/arcads-claude-code.git
cd arcads-claude-code

# 运行交互式安装
./scripts/setup.sh

setup 脚本会:1) 提示输入 Arcads API Key(从 app.arcads.ai/settings/api 获取);2) 创建含凭证的 .env 文件;3) 创建 MASTER_CONTEXT.md 工作区文件;4) 验证 API 连接。

.env 中需包含:

ARCADS_API_KEY=your_api_key_here

调用方式

技能以 Python/API 客户端模式调用,基础地址为 https://api.arcads.ai,请求头使用 Authorization: Bearer <API_KEY>。典型流程为提交任务、获取 jobId、轮询至 completed 或 failed。文档中各工作流给出对应端点示例,如 /v1/seedance2/video、/v1/veo3.1/video、/v1/sora2/video、/v1/b-roll、/v1/scene、/v1/nano-banana/image、/v1/chatgpt-image/ad、/v1/image-ad/analyze 等。

适用场景

  • 需要批量产出短视频广告素材的营销团队与创作者。
  • 需要生成 AI 网红形象、产品展示图、UGC 风格静图的内容制作。
  • 需要按已验证模板快速制作 Meta 静态图片广告。
  • 需要多步动画广告(皮克斯风格、黏土动画)与字幕烧录流程的制作。

限制

  • 价格、计费方式、额度与具体费用信息暂未提供(代码中出现 estimatedCost 字段,但未给出定价规则)。
  • 各模型的具体参数范围、配额、生成成功率、并发与速率限制暂未提供。
  • 平台兼容性仅提及 Claude Code 与 Cursor;其他平台支持情况暂未提供。
  • 关于 37 个模板的完整清单与逐项说明,资料中仅给出部分示例,其余暂未提供。