已就绪内容按当前版本翻译;动态数量、项目输入等部分界面仍可能显示中文原文。
编程与开发 · 火山方舟

Ark CLI

在本地終端或 AI Agent 中以自然語言完成火山方舟認證、模型呼叫、推理部署與帳單查詢的官方命令列工具。

AI 辅助整理
命令列工具模型呼叫推理部署模型精調用量帳單

工具介紹

Ark CLI 是火山方舟平台的官方命令列工具,支援在本地終端完成登入認證與資源管理,也可作為 Skill 安裝到 Claude Code、Cursor、TRAE、Gemini CLI 等常用 AI Agent,透過自然語言觸發模型呼叫、推理接入點管理、圖片影片生成、內容生成與用量帳單查詢。安裝依賴 Node.js 16 及以上,可透過 NPM 全域安裝,適合需要與方舟平台互動的開發者和團隊使用。

核心能力涵蓋認證與身份(arkcli auth、profile,支援多 Profile 切換與 API Key 管理)、對話與推理(多模態、多輪、串流輸出,arkcli +chat)、圖片/影片生成(arkcli +gen)、多模態理解(arkcli +understand)、模型探索(arkcli models)、推理資源與部署(arkcli infer、+deploy)、模型精調(arkcli train,涵蓋 SFT、LoRA、DPO 及 RL 訓練,支援資料校驗、超參數與費用預覽)、Managed Agents 管理(arkcli agent)、文件檢索(arkcli docs)、用量統計(arkcli usage)、帳單與定價(arkcli billing、pricing)、方案與席位(arkcli plans)、Agent 整合(arkcli +connect)、程式碼範例(arkcli +code-example)與診斷(arkcli doctor,可驗證圖片影片產物來源)。命令遵循快捷命令、領域命令和原始 API 呼叫三種結構,並支援 --api-key、--base-url、--dry-run、--profile、--region、--format json 等全域旗標。

適合誰用

使用火山方舟平台的開發者、演算法工程師和需要管理模型呼叫、推理接入點與帳單用量的技術團隊成員。

建議使用步驟

  1. 01

    確認本機已安裝 Node.js 16 及以上版本。

  2. 02

    在終端執行 npm install -g @volcengine/ark-cli 安裝,並用 arkcli --version 驗證。

  3. 03

    執行 arkcli auth login volc-sso 透過火山 SSO 瀏覽器登入,或用 arkcli auth login --no-browser 在無瀏覽器/遠端終端登入。

  4. 04

    執行 arkcli +connect 將 Ark CLI Skill 安裝到常用 AI Agent(如 Claude Code、Cursor、TRAE 等)。

  5. 05

    重啟 AI Agent 後以自然語言下達需求,例如查詢模型、查詢用量、生成圖片影片或部署 Endpoint。

  6. 06

    如需解除安裝 Skill,執行 arkcli +connect uninstall。

使用前了解

環境要求 Node.js >= 16。登入支援火山 SSO 瀏覽器登入(推薦)與 --no-browser 無瀏覽器/遠端終端登入兩種方式。Skill 支援安裝到 Claude Code、Codex、Cursor、TRAE、Gemini CLI 等 AI Agent。具體方案費用與帳號權限需以官網為準。

费用与套餐:官方文件顯示用量統計支援查詢免費額度或資源包餘額,方案與席位支援查詢、購買和續約 Agent Plan / Coding Plan,具體價格需以官網為準。

選型助手

让需求变成可修改的筛选条件

依据已录入参数生成条件,结果可查看和修改。帧率与性能需核对实测,不能仅凭算力数值保证。