跳轉到主要內容
blon 指令以你的 Blon 帳號執行並使用帳號點數,Skills 也是透過它執行。

安裝

@blon/cli 尚未發行到 npm,以下指令在第一個版本發行後即可使用。
需要 Node.js 22 以上。

登入

blon auth login 使用裝置授權流程:印出網址與代碼,並在瀏覽器開啟核准頁,以登入中的 Blon 帳號核准即可。在 SSH 或容器中不會開啟瀏覽器,請在任何裝置上開啟印出的網址。 登入憑證存在 ~/.config/blon/credentials.json(權限 0600),可用 BLON_CONFIG_DIR 改放其他位置。blon whoami 顯示帳號、站台、工作區與餘額。

第一個生成

模型的每個輸入就是一個旗標:--<inputId> <value>,用 blon models get <id> 查看。list 型輸入用逗號分隔或重複旗標;負數寫成 --seed=-1。

媒體輸入

媒體旗標可給本機檔案路徑、https:// 網址或 asset id。本機檔案會自動上傳(圖片上限 20,000,000 bytes,其他檔案 52,428,800 bytes)。

音色輸入

音色旗標給模型的預設音色 id(blon models get <id> 會列出可用的),或用 workspace:<voiceId> 指定工作區音色。

指令

generate 的旗標: 等待中斷時,用 blon jobs wait <id> 接著等,不要重新提交。 全域旗標:--json、--workspace <slug>、--base-url <url>、--help、--version。

JSON 輸出

加上 --json 時,stdout 只有回應 JSON,進度都在 stderr;搭配 --wait 就是整筆完成的工作。

離開碼

環境變數

CI

無人值守時設定 BLON_API_KEY,不需要 blon auth login。此時 CLI 花的是金鑰所屬工作區的餘額。