作业与费用

配置发布版 CLI

按安装指南安装 envloop-cli。本页命令基于发布版 0.1.1，与 envloop 源码 CLI 的 train submit/status 不同。

export ENVLOOP_BASE_URL=https://api.envloop.ai
export ENVLOOP_WORKSPACE_ID=YOUR_WORKSPACE_ID
export ENVLOOP_API_KEY="$(cat /absolute/private/platform.key)"

使用自己的工作区和已有私有 KEY 文件。显式全局参数 --api-url、--workspace-id 覆盖环境变量，且必须放在 train 之前。

查询作业

el train job list --limit 25
el train job list --status running --limit 25
el train job status TRAIN_JOB_ID

输出为 JSON。使用返回的 train_job_id，不要使用 Agent job_id 或 Trial ID。列表返回 next_cursor 时继续查询：

el train job list --cursor NEXT_CURSOR --limit 25

Train Job 状态描述训练进度；云机器运行不等于模型 ready。成功终态不能单独证明云资源释放或 Checkpoint 下载校验。保留作业、Session ID，并检查脚本 finish 结果。

查询 Checkpoint

el train checkpoint list --limit 25
el train checkpoint list --session-id SESSION_ID --limit 25
el train checkpoint list --run-id RUN_ID --limit 25

Session/run ID 从训练详情或脚本记录取得，不要用 train_job_id 替代。列表仅包含已登记产物，当前最多 100 条，无 cursor 分页。保存、恢复和下载校验见 Checkpoint 与恢复。

查询估算用量

el train billing usage 2026-10-10 2026-10-11

日期格式为 YYYY-MM-DD，依次为 starting_on、ending_before。当前平台校验日期，但没有按区间过滤用量。estimate: true 不是正式结算账单。按准确 Session 与提供方记录核对；已有 GPU smoke 留有卡型与费率归属差异。

常见问题

现象	核对项
命令不存在	command -v el、包版本和 el train --help；源码与发布版命令不同
401	平台机器 KEY、有效期和撤销状态；SDK 脚本还须配置 credential command
403 或资源找不到	工作区成员关系、权限和提交者；另一用户的 KEY 不自动拥有当前作业
503	联系管理员核对训练服务配置；安装 CLI 不会部署后端
Checkpoint 为空	Session/run 是否正确，save、发布与登记是否完成
超时	网络、代理、资源准备或后端故障；超时不代表 GPU 已停止

SDK 失败后，应尽可能显式 finish 为 errored/interrupted。SFT 示例在清理路径尝试该操作；finish 失败时需管理员按准确 Session 继续处理。不要从只读接口可用推断托管提交或取消已启用。