平台
一個 CLI 與技能包，多種代理介面
在你的團隊既有的工作環境中使用 Codia runtime CLI 與公開技能包。
Codex
透過本機驗證將 Codia 的圖片、PDF 與設計 API 加入 Codex 技能。
Claude
將相同的指令封裝成可重複使用的 Claude 技能，用於設計自動化任務。
Cursor
在 Cursor 規則中公開 Codia API 指令，用於編程與設計轉程式碼的工作流程。
功能
為代理執行而封裝的設計 API
CLI 負責驗證、上傳、API 呼叫與 JSON 輸出，讓代理能專注於使用者的任務。
圖片轉設計
將螢幕截圖與 UI 圖片轉換為結構化、可編輯的設計資料。
PDF 轉設計
從 PDF 檔案中擷取頁面版面、文字與視覺結構。
PDF 轉 PPT
從圖片型 PDF 與文件頁面產生可編輯的 PowerPoint 輸出。
去背
為商品、人像與創意素材建立乾淨的去背圖。
圖片生成
透過 Codia 端點生成、放大、編輯、重混與描述圖片。
SVG 轉換
將圖片素材轉換為可縮放的 SVG 輸出，用於設計與開發。
成果
清楚的輸入，代理可讀的輸出
每個指令都讓 API 呼叫一目了然，並回傳代理可繼續使用的結構化輸出。
輸入
screenshot.png
指令
image-to-design --out design.json
輸出
可編輯的設計 JSON
輸入
deck.pdf
指令
pdf-to-ppt --poll --out deck.json
輸出
PPTX 下載連結
輸入
product.png
指令
remove-bg --out cutout.json
輸出
透明素材連結
安裝
簡短的設定，以即時餘額檢查作結
安裝 CLI 與公開技能包，透過瀏覽器登入或 Open API 金鑰進行驗證，然後確認你的額度可以存取。
安裝 CLI
使用 npm 安裝跨平台的 codia-design 指令。
綁定你的 API 存取權
在可用時使用瀏覽器登入，或直接綁定既有的 Codia Open API 金鑰。
安裝技能包
將公開的 Codia Design Skills 技能包加入支援的本機代理。
$ npm install -g @codia-ai/codia-design-cli$ npx -y skills add codia-ai/codia-design-skills -g -y$ codia-design auth login --platform codex$ codia-design credits
計費
一個 Open API 額度餘額，適用於每個指令
Codia Open API 使用統一的 Open API 額度方案。使用者只需購買或訂閲一次，即可在所有公開 API 功能中使用同一份餘額。
統一方案
圖片、PDF、PPT、SVG 與去背 API 共用同一份餘額。
用量可視化
從 CLI 或儀表板查看剩餘額度與各次呼叫的用量。
自動儲值
選用的儲值設定可避免正式環境的代理工作流程中斷。
codia-design creditscodia-design usage --page 1 --page_size 20codia-design auto-recharge set --enabled true --threshold 100 --credits 1000 --monthly_max 5000
工作流程
適用於常見設計任務的代理就緒指令
每個指令都回傳結構化 JSON，並可將大型回應寫入檔案，供後續代理步驟使用。
codia-design image-to-design
將 UI 螢幕截圖轉換為 DSL
代理可以檢視螢幕截圖、呼叫 Codia，並使用回傳的設計結構來生成程式碼或簡報。
codia-design pdf-to-ppt --poll
將 PDF 轉換為可編輯的投影片
長時間執行的轉換任務可從 CLI 輪詢，並儲存為可重複使用的輸出。
codia-design remove-bg
準備商品與創意素材
本機檔案會自動上傳，接著結果便可流入設計或內容管線。
常見問題
團隊需要知道的事
這些技能是 Codia Open API 之上一層輕量的本機封裝。
我需要 Codia API 金鑰嗎？
需要。在可使用裝置流程驗證時使用瀏覽器登入，或以既有的 Open API 金鑰執行 codia-design auth set --api-key。
支援哪些平台？
為支援的本機代理安裝公開的 Codia Design Skills 技能包；一個 CLI 即可驅動所有 API 呼叫。
額度是否在各 API 之間共用？
是的。公開 Open API 呼叫皆從統一的 Codia Open API 餘額扣除。
代理可以使用本機的圖片與 PDF 檔案嗎？
可以。CLI 會在呼叫目標端點前先上傳支援的本機檔案。
這和 REST API 有什麼不同？
它將相同的 Codia Open API 端點封裝成指令與技能説明，讓本機 AI 代理能安全地使用。