blon 指令以你的 Blon 帳號執行並使用帳號點數,Skills 也是透過它執行。
安裝
@blon/cli 尚未發行到 npm,以下指令在第一個版本發行後即可使用。登入
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 花的是金鑰所屬工作區的餘額。