按状态、类型与项目筛选列出训练任务

PIN API 允许你列出账户中的所有训练任务。每个条目包含最新的训练进度、调度状态与超参数摘要，便于快速浏览工作负载的整体状态。

方法与路径

GET /v1/jobs

认证

在 Authorization 头中以 Bearer 令牌的形式携带你的 PIN API 令牌或 JWT。

Authorization: Bearer <token>

查询参数

string

按任务状态筛选。允许的值：queued、running、paused、stopped、succeeded、failed、cancelled、intervening。

string

按训练类型筛选。允许的值：sft、opd、pretrain、distill、qat、grpo、dpo、kto、orpo、simpo、ppo。

string

按项目或基座模型名称前缀筛选。

请求示例

curl -s "https://api.ariacompute.com/v1/jobs?status=running&type=sft" \
  -H "Authorization: Bearer $PIN_API_TOKEN"

响应

返回标准的 PIN 成功信封，任务列表位于 data.items 下。

integer

required

成功为 0，出错为非零值。

object

required

Show 属性

array

required

任务对象列表。

Show 任务对象

string

唯一任务标识符（例如 jb_...）。

string

训练类型：sft、opd、pretrain、distill、qat、grpo、dpo、kto、orpo、simpo、ppo。

string

来自目录的基座模型名称。

string

用于 OPD 或蒸馏的冻结教师模型。

object

LoRA/QLoRA/DoRA 配置。

object

训练超参数。

object

若已启用，则为自动干预配置。

string

关联的数据集标识符。

string

当前任务状态。

string

控制器调度状态。

string

执行该任务的智能体 ID。

integer

分配给任务的 GPU 索引。

string

MLflow 运行标识符。

string

MLflow 运行的直接 URL。

string

最近一次错误消息（若有）。

object

响应示例

{
  "code": 0,
  "data": {
    "items": [
      {
        "job_id": "jb_abc123def456",
        "type": "sft",
        "base_model": "meta-llama/Llama-3-8B",
        "lora": {
          "method": "lora",
          "rank": 16,
          "alpha": 32,
          "lora_dropout": 0.05,
          "target_modules": ["q_proj", "v_proj"],
          "quantization": "4bit_nf4"
        },
        "hyperparams": {
          "epochs": 3,
          "lr": 0.00002,
          "max_length": 2048
        },
        "dataset_id": "ds_xyz789",
        "status": "running",
        "dispatch_status": "running",
        "agent_id": "ag_node01_001",
        "gpu_index": 0,
        "progress": {
          "step": 1240,
          "loss": 0.8234
        },
        "created_at": "2025-01-15T09:23:17Z"
      }
    ]
  },
  "message": ""
}

错误

Code	HTTP	含义
401	401	缺失或无效的 Bearer 令牌。
500	500	内部服务器错误。

该接口最多返回 100 个任务，按 created_at 降序排列。

PIN API

ROUTER API

AGENT API

按状态、类型与项目筛选列出训练任务

方法与路径

认证

查询参数

请求示例

响应

响应示例

错误

​方法与路径

​认证

​查询参数

​请求示例

​响应

​响应示例

​错误

方法与路径

认证

查询参数

请求示例

响应

响应示例

错误