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 金鑰設定為環境變數：

export ATLASCLOUD_API_KEY="your-api-key"

若要在終端機工作階段之間持續生效，請將這一行加入 shell 設定檔（~/.bashrc、~/.zshrc 等）。

在 Atlas Cloud 主控台建立金鑰。詳情請參閱 API 金鑰。

助手會代您執行 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。