AITOPIA

AITOPIA 技能

使用 AITOPIA 创建、编辑和分析图像、视频、配音和音乐的 AI Agent 技能，还包括 AITOPIA 为产品广告、UGC 视频、短视频、YouTube 缩略图和品牌套件提供的制作指南。适用于 Claude Code、Codex、Cursor 等可加载 Markdown 技能的 Agent，也适用于任何通过 AITOPIA 服务连接的 MCP 客户端。

所有操作都通过 AITOPIA MCP 服务（https://mcp.aitopia.ai/mcp）在你的 AITOPIA 账户中完成。无需在本地安装任何内容：首次使用 AITOPIA 时会打开浏览器进行登录，所有结果都会保存到你的账户中，你可以继续处理这些内容。

安装

任选一种。插件安装方式（Claude Code、Codex、Cursor）会为你连接 AITOPIA 服务。

Claude Code marketplace — 推荐用于 Claude Code

/plugin marketplace add AITOPIAai/skills
/plugin install aitopia@aitopia

npx skills — 跨 Agent

npx skills add AITOPIAai/skills

将技能安装到 Claude Code、Codex、Cursor 以及许多其他 Agent 中。还需连接一次 AITOPIA 服务（参见 INSTALL.md）。

Codex

codex mcp add aitopia --url https://mcp.aitopia.ai/mcp
codex mcp login aitopia
npx skills add AITOPIAai/skills --agent codex

一键安装：Cursor、VS Code、Gemini CLI

Gemini CLI（服务 + 制作指南）：

gemini extensions install https://github.com/AITOPIAai/skills

其他 MCP 客户端：添加远程服务 https://mcp.aitopia.ai/mcp（Streamable HTTP，通过 OAuth 登录）。

Claude（网页和桌面应用）

前往设置 → 连接器 → 添加自定义连接器 → https://mcp.aitopia.ai/mcp，然后使用 AITOPIA 登录。生成的图像和视频会直接显示在对话中。

ChatGPT

前往 chatgpt.com/plugins → 添加 → 创建 MCP App，输入 https://mcp.aitopia.ai/mcp，然后使用 AITOPIA 登录。现在无需启用开发者模式。

AITOPIA CLI（终端）

npm i -g aitopia
aitopia login
aitopia image "a red paper boat on a pond"
aitopia dub video.mp4 --to Spanish --dry-run

aitopia --help 会列出所有命令（image、video、audio、edit、analyze、transcribe、dub、upload、models 等）。

更多选项请参见 INSTALL.md。由 Agent 驱动的安装方式（粘贴到你的 Agent 中）：INSTALL_FOR_AGENTS.md。

技能

技能	功能
aitopia-generate /aitopia:aitopia-generate	生成图像、视频、配音、音乐和音效。像 AITOPIA 一样为任务选择合适的模型；一次调用即可同时返回多张图像。
aitopia-edit /aitopia:aitopia-edit	合并片段、添加配音或音乐、裁剪、调整为 9:16 / 16:9 / 1:1、叠加文字和 Logo、添加字幕、淡入淡出、调整速度、静音 / 提取 / 规范化音频、为静态图像制作动画。
aitopia-upload /aitopia:aitopia-upload	将本地照片、视频、音频文件或文档发送到 AITOPIA（最大 95 MB；通过公开 URL 上传时最大 200 MB）。
aitopia-product-ad /aitopia:aitopia-product-ad	根据产品照片制作产品广告片：主视觉关键帧、动态效果、配音和音乐。
aitopia-ugc-video /aitopia:aitopia-ugc-video	创作者风格的 UGC 广告——用户评价、前后对比、吸睛视频、手机拍摄效果。
aitopia-short-video /aitopia:aitopia-short-video	端到端制作 TikTok / Reels / Shorts、发布和促销视频。
aitopia-youtube-thumbnail /aitopia:aitopia-youtube-thumbnail	制作高点击率的 YouTube 缩略图：醒目的主体、高对比度、清晰易读的大字。
aitopia-brand-kit /aitopia:aitopia-brand-kit	Logo 设计方向、配色方案、字体排印和使用规则。

第二行是 Claude Code 插件中的命令；使用 npx skills 时，命令就是技能名称，例如 /aitopia-generate。

当请求适合使用这些技能时，Agent 也会自行调用。工作流技能背后的操作指南存放在 AITOPIA 上，并会在运行时加载，因此无需重新安装即可持续改进。

这些技能可以串联使用：aitopia-upload 将本地文件转换为其他技能都能接受的资源 URL；aitopia-generate 生成静态图像和视频片段，供 aitopia-edit 组装；工作流技能（product-ad、ugc-video、short-video、youtube-thumbnail、brand-kit）会同时调用这两者。

视频分析

询问 Agent 视频、图像或音频文件中有什么，它就会使用 AITOPIA 的 analyze_media 工具。Agent 会观看视频并聆听音频，然后给出回答：

• **摘要：**发生了什么、说了什么、画面中的文字、音乐和声音。
• **场景：**每个镜头及其起止时间，可直接用于使用 aitopia-edit 剪辑。
• **广告评审：**10 分制评分、吸引点、信息、行动号召、节奏、优点和改进建议。
• **重新创作提示词：**使用 aitopia-generate 制作类似图像或视频的提示词。
• 你的问题：“前 3 秒内能看到 Logo 吗？”、“这适合儿童观看吗？”

它可以用任何语言回答。试试在 Claude、ChatGPT、Cursor 或 Codex 中使用：

Analyze this video and list every scene with its time: <video URL>
Score this ad and tell me how to improve the first 3 seconds: <video URL>
Write a prompt that re-creates this image: <image URL>

目前视频最大为 2 MB。每次分析约花费 3 个点数，运行失败则不收费。你可以先询问价格，Agent 会使用 dryRun 检查，不会实际运行。同样的分析功能也可通过 AITOPIA CLI（aitopia analyze clip.mp4 --mode scenes）和 AITOPIA chat 使用。

快速参考

你想要什么	技能	说明
一张图片，或同一主题的多个选项	aitopia-generate	单次调用最多生成 4 张图片，并排显示
根据提示词或照片生成一段短视频	aitopia-generate	长时间运行的任务会在后台完成；结果就绪后会显示
配音、音乐或音效	aitopia-generate	配音和音乐使用不同的模型
使用电脑中的照片或视频	aitopia-upload	然后将素材 URL 传给任意技能
拼接片段、添加音乐或配音	aitopia-edit	video_editor 也可以首尾拼接音频文件
为 Reels / TikTok / YouTube 重新调整画面	aitopia-edit	使用 resize，并设置 fit cover / contain
标题、字幕、徽标	aitopia-edit	add_text、overlay、subtitle
移除背景、提升分辨率、修复	aitopia-generate	AITOPIA 会选择合适的模型或商店 Agent
了解视频、图片或音频中的内容	analyze_media 工具	摘要、语音、屏幕文字、音频；视频最大 2 MB
查看视频中的每个场景及其时间	analyze_media 工具	mode: scenes；然后使用 aitopia-edit 剪辑
审核广告（评分、吸引点、CTA）	analyze_media 工具	mode: ad_review
生成可重现视频或图片的提示词	analyze_media 工具	mode: prompt；然后使用 aitopia-generate
产品广告	aitopia-product-ad	从产品照片开始
UGC 广告	aitopia-ugc-video	创作者风格，营造手机拍摄的感觉
YouTube 缩略图	aitopia-youtube-thumbnail	可从多个变体中选择
品牌形象	aitopia-brand-kit	徽标方向、配色方案、字体

组合使用多项技能的配方：COOKBOOK.md。

积分

生成会消耗账户中的 AITOPIA 积分；编辑和上传的费用很低或免费。如果任务需要更多积分，结果中会附上 aitopia.ai/pricing 链接。

许可证

MIT — 参见 LICENSE。