用途 该技能用于通过 Arcads 外部 API 生成和获取 AI 视频、图像及相关素材，覆盖 UGC 短视频、产品展示、角色与数字人、B-roll、场景、脚本等多种创作流程。
配置与鉴权 基础地址为 https://external-api.arcads.ai（或环境变量 ARCADS_BASE_URL）。鉴权使用 HTTP Basic：以 ARCADS_API_KEY 作为用户名、密码为空（除非 Arcads 文档另有说明）。示例命令：curl -u "$ARCADS_API_KEY:" "$ARCADS_BASE_URL/v1/products"。要求不打印 API 密钥、不提交 .env、不把密钥写入 MASTER_CONTEXT.md；首次调用前确认 .gitignore 已排除 .env。若密钥缺失或返回 401/403，默认做法是引导用户在 .env 中填入密钥；若用户坚持在对话中粘贴，则代为写入 .env 并提醒聊天记录可能留存密钥、建议轮换。
主要能力与调用入口 所有视频模型统一走 POST /v2/videos/generate，通过 model 字段区分：seedance-2.0、sora2、veo31、kling-3.0、grok-video。图像使用 POST /v2/images/generate，默认 model 为 nano-banana-2，可选 nano-banana（Nano Banana Pro）。其他接口包括 Sora 2 视频 remix（POST /v1/sora2/remix/video）、B-roll（POST /v1/b-roll）、场景生成（POST /v1/scene）、数字人脚本（POST /v1/scripts 及 /v1/scripts/{id}/generate）、OmniHuman（POST /v1/omnihuman）、音频驱动（POST /v1/audio-driven）。
典型工作流
- 产品评测/UGC 自拍、产品高光、产品英雄镜头、lookbook、功能演示：均使用 Seedance 2.0，并配合对应 prompt 库文件。
- 从参考图重建网红或产品展示：先用 Nano Banana 生成静帧并取得用户确认，再以该静帧作为 Veo 3.1 视频的起始帧。
- 从文本创建 AI 网红角色设定表：先生成主肖像，再以主肖像为参考生成多角度图；可选用 ChatGPT Image 2 做风格化版本。
- 皮克斯风格、黏土动画风格广告：先锁定角色表，再用 ChatGPT Image 2 出分镜静帧，然后用 Seedance 2.0 逐镜头图生视频，最后用 ffmpeg 拼接并烧录字幕。
- 给成品视频加字幕：走独立流程（hyperframes 初始化、转写、生成字幕 HTML、渲染并用 ffmpeg 叠加），不调用 Arcads API。
会话与成本管理 每次生成素材的会话会按日期创建文件夹和项目（先查产品、复用或新建“Arcads API - YYYY-MM-DD”文件夹与项目），并在生成调用中带上 projectId，便于在 Arcads 控制台查找素材。生成前必须估算并展示积分成本，来源依次为 logs/arcads-api.jsonl 历史记录、MASTER_CONTEXT.md 费率表、向用户询问；不得编造数字，且需等待用户确认后再生成。默认每个提示词生成 1 个变体，多于 1 个时以相同载荷并行发起多次独立请求。
对话与时长 含人物说话的视频需先提取对话、以编号列表展示并单独取得用户确认，之后才进入成本确认与生成；按约 2.5 词/秒估算时长，Sora 2 时长枚举为 4、8、12、16、20 秒，Veo 3.1 无时长字段。Seedance 2.0 生成前需询问是否开启音频输出及是否提供参考音频。B-roll 与图像流程无对话。
适用场景与限制 适用于 AI 广告与营销视频、UGC 内容、产品展示、数字人口播、图像生成与角色设定等创作任务。限制包括：需自备 Arcads API 密钥；API 不提供计费接口，成本只能估算；部分流程依赖 ChatGPT Image 2、ffmpeg 等外部工具；提示词必须遵循对应模型指南；API 无批量参数，多版本需多次请求。