编程与开发 · 火山方舟

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,具体价格需以官网为准。

选型助手

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

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