快速开始

几分钟内从模板启动一个交互式实例，并在浏览器里打开 Jupyter。

前提条件

• 注册 方舟智算账号
• 账户充值（实例按卡按分钟计费，余额需覆盖至少 1 小时的运行费用才能启动）

全程可在 控制台 图形界面完成。下文同时给出等价的 REST API 调用，方便脚本化。API Token 在 设置 → API 密钥 创建。

export ARK_TOKEN="ak_your_token_here"
export ARK_API="https://api.arkcore.cloud/api/v1"

第一步：挑一个模板

进入控制台 模板（/app/templates），浏览官方与社区模板（PyTorch、vLLM、ComfyUI 等）。每个模板预置了镜像、CUDA 版本、磁盘建议、要暴露的端口和启动脚本。

点击模板上的「使用」，会带着该模板进入算力市场页，作为"当前模板"预选。

等价 API（返回模板规格，并使计数 +1）：

curl -X POST "$ARK_API/templates/$TEMPLATE_ID/use" \
  -H "Authorization: Bearer $ARK_TOKEN"

详见 使用任务模板。

第二步：在算力市场选机器

进入 算力市场（/app/market）。市场会按当前模板的需求（CUDA 版本、磁盘、GPU、端口）筛选兼容机器。每台机器按卡定价，你可以选择租用的 GPU 卡数。

按 GPU 型号、地区、价格筛选并记下机器 node_id：

curl -s "$ARK_API/market/nodes?gpu_series=rtx40&max_price=5&sort=price_asc" \
  -H "Authorization: Bearer $ARK_TOKEN" | jq '.nodes[0].id'

详见 浏览算力市场。

第三步：启动实例

方式 A：控制台

在市场选中机器 → 选 GPU 卡数与磁盘 → 确认价格 → 创建。实例会先进入 provisioning，拉取镜像后变为运行中。

方式 B：REST API

创建一个交互式实例（基于第一步模板的镜像）：

curl -X POST "$ARK_API/rentals" \
  -H "Authorization: Bearer $ARK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "node_id": "NODE_ID_HERE",
    "launch_mode": "interactive",
    "app": "jupyter",
    "template_image": "pytorch/pytorch:2.3.0-cuda12.1-cudnn8-runtime",
    "gpu_count": 1,
    "disk_gb": 40,
    "ports": [{ "port": 8888, "label": "jupyter", "open_button": true }]
  }'

响应里包含 rental.id。创建后需要 start 才真正下发并开始计费（控制台「创建」按钮已包含这一步）：

RENTAL_ID="<上一步返回的 id>"
curl -X POST "$ARK_API/rentals/$RENTAL_ID/start" \
  -H "Authorization: Bearer $ARK_TOKEN"

余额需覆盖至少 1 小时的运行费率（计算 + 存储），否则返回 402 INSUFFICIENT_BALANCE。

第四步：打开 Jupyter / 终端 / SSH

实例进入 running 后，控制台上的按钮会变绿，点击即可在浏览器打开。等价 API 返回访问地址：

curl -s "$ARK_API/rentals/$RENTAL_ID/access" \
  -H "Authorization: Bearer $ARK_TOKEN" | jq

{
  "instance_status": "running",
  "tunnel_hostname": "i-ab12cd34.inst.arkcore.cloud",
  "access": {
    "jupyter_url": "https://i-ab12cd34.inst.arkcore.cloud/lab",
    "terminal_url": "https://i-ab12cd34-term.inst.arkcore.cloud/",
    "ssh_cmd": "ssh -p 22001 root@203.0.113.5"
  }
}

直接在浏览器打开 jupyter_url 即可——无需本地安装。详见 交互式实例。

第五步：停止或销毁

用完后两种选择，计费影响不同：

# 停止：释放 GPU、停止计算费用、保留数据，可随后重启（仍计存储费）
curl -X POST "$ARK_API/rentals/$RENTAL_ID/stop" -H "Authorization: Bearer $ARK_TOKEN"

# 销毁：删除容器与实例卷、释放 GPU、终结全部费用（不可恢复）
curl -X DELETE "$ARK_API/rentals/$RENTAL_ID" -H "Authorization: Bearer $ARK_TOKEN"

停止 vs 销毁的语义见 实例生命周期。

下一步

• 核心概念 — 模板 / 实例 / 租用 / 按卡计费 术语
• 实例生命周期 — 停止 / 重启 / 销毁 / 自动续期
• 存储卷与快照 — 跨实例存活的持久存储
• 计费说明 — 计算与存储如何计量