Skills

安装 Atlas Cloud Agent Skills，让 Claude Code、Codex CLI 和 Gemini CLI 通过 Atlas Cloud API 生成图像、视频、音频和 3D 模型。

什么是 Skills？

Skills 是可复用的知识包，用来把某个具体领域教给 AI 编程助手：API 参考、参数规则、模型选型，以及可直接使用的代码模板。安装 Atlas Cloud Skills 之后，你的助手就能准确理解 Atlas Cloud API，从而根据自然语言指令生成图像、视频、音频和 3D 模型，并写出正确的集成代码。

Atlas Cloud Skills 适用于 Claude Code、OpenAI Codex CLI、Gemini CLI，以及其他支持同一 Skill 格式的助手。

GitHub 仓库：AtlasCloudAI/atlas-cloud-skills

包含内容

仓库中提供 三个 Skill：

atlas-cloud

核心 Skill。覆盖图像、视频、音频、3D、LLM 对话、媒体上传和模型查询的完整 API 参考。

seedance-2-5-skill

面向 Seedance 2.5 的专用 Skill——分镜脚本、多模态参考素材，以及原生音视频生成。

universal-video-prompt-skill

与模型无关的视频提示词方法：把粗略的想法转化为结构化的镜头级提示词。

核心 Skill 的内部结构

atlas-cloud 由一个 SKILL.md 入口文件，加上七份按需加载的参考文档组成：

参考文档	内容
`references/image-gen.md`	图像生成，包括 3D 模型
`references/video-gen.md`	视频生成、唇形同步和数字人
`references/audio-gen.md`	语音合成、音乐生成和语音转文本
`references/llm-chat.md`	兼容 OpenAI 的对话补全
`references/quick-generate.md`	一步式生成，自动帮你选择模型
`references/upload.md`	上传本地文件，用于图生视频和图像编辑工作流
`references/models.md`	模型查询、定价和能力检索

配方库

除了 Skill 本身，仓库还提供 25 个开箱即用的配方——助手可以直接照着执行的端到端工作流：

类别	配方数	示例
`library/visual`	7	产品摄影、海报设计、风格迁移
`library/motion`	6	产品渲染图转广告、角色转剧情镜头
`library/edit`	6	抠图去背景、杂物清除、超分放大
`library/social`	6	长视频转竖版短视频、封面图生成

安装

安装全部三个 Skill：

npx skills add AtlasCloudAI/atlas-cloud-skills

只安装其中一个：

npx skills add AtlasCloudAI/atlas-cloud-skills --skill atlas-cloud

配置

把 API Key 设置为环境变量：

export ATLASCLOUD_API_KEY="your-api-key"

要在终端会话之间持久生效，请把这行加入 shell 配置文件（~/.bashrc、~/.zshrc 等）。

在 Atlas Cloud 控制台创建密钥。详情参见 API Key。

助手会代替你执行 shell 命令。请把密钥保存在环境变量或密钥管理服务中——不要提交到代码仓库，也不要粘贴到提示词里。

使用示例

安装完成后，用自然语言描述你的需求即可：

图像与 3D

“用 Seedream v5.0 Pro 生成一张陶瓷马克杯放在亚麻背景上的产品照”

“把这张照片转成可以在 Blender 里打开的 3D 模型”

视频

“用 Seedance 2.5 生成一段 5 秒的黄金时刻海浪片段”

“拿这张产品渲染图做一支 15 秒的广告，配上旁白”

音频

“用温柔的女声朗读这段文字，并保存为 MP3”

“写一首关于夏日公路旅行的 90 秒欢快流行歌并生成出来”

“转写这段采访录音，并给我区分说话人的文本”

LLM 与模型查询

“让 DeepSeek V3.2 审查这个文件有没有安全问题”

“哪些视频模型支持参考图？价格分别是多少？”

支持的能力

能力	端点	示例模型
图像生成	`POST /api/v1/model/generateImage`	Seedream v5.0 Pro、FLUX 2、Qwen Image 3.0
3D 生成	`POST /api/v1/model/generateImage`	Hunyuan3D Pro、Seed3D 2.0、Tripo H3.1
视频生成	`POST /api/v1/model/generateVideo`	Seedance 2.5、Kling、Wan 3.0、Veo
语音合成	`POST /api/v1/model/generateAudio`	Seed Audio 1.0、ElevenLabs、MiniMax Speech
音乐生成	`POST /api/v1/model/generateAudio`	Suno Chirp v5、MiniMax Music 3.0
语音转文本	`POST /api/v1/model/generateAudio`	Seed ASR 2.0、xAI STT v1
LLM 对话	`POST /v1/chat/completions`	DeepSeek、Qwen、Kimi、GLM、MiniMax
媒体上传	`POST /api/v1/model/uploadMedia`	把本地文件转成托管 URL
模型查询	模型库检索	按名称、类型或提供商搜索

3D 生成走的是图像端点，语音、音乐和转写则共用音频端点。具体走哪条路径由你选择的模型决定，而不是由 URL 决定。完整的请求与轮询流程参见音频模型和预测任务。

该用 Skills 还是 MCP Server？

两者都能把 Atlas Cloud 接入你的开发环境，但解决的问题不同：

	Skills	MCP Server
适用工具	Claude Code、Codex CLI、Gemini CLI，以及其他支持 Skill 的助手	Claude Code、Cursor、Claude Desktop、VS Code、Windsurf、Cline 等
提供什么	领域知识、参数规则和代码模板	助手可直接调用的可执行工具
配置成本	一条命令	每个客户端一份 JSON 或 TOML 配置
最适合	编写集成代码、多步骤的创作工作流	不离开编辑器直接跑生成任务

建议两者都用。 MCP Server 负责执行调用；Skills 负责告诉助手该选哪个模型、哪些参数真正重要。

配置方法参见 MCP Server 指南。

在 DeepSeek Harness 中使用 Skills

如果你在 DeepSeek Harness 中工作，dsh-media-gen 把这些 Skill 打包成了一个 profile 插件：

dsh plugin --profile web add 'github:AtlasCloudAI/dsh-media-gen#v0.2.0'
export ATLASCLOUD_API_KEY="your-api-key"

该插件包会跟随上游 Skill 更新，也可以选择同时启用 Atlas Cloud MCP Server。