OpenAI 列出微调任务
2026-11-10 18:58 更新
GET /v1/fine_tuning/jobs
分页查询组织中的微调任务。
查询参数
| 字段 | 说明 |
|---|---|
after |
可选字符串,上一页最后一个任务的 ID。 |
limit |
可选整数,默认 20。 |
metadata |
可选的字符串映射,可为 null,用于按元数据筛选任务。 |
响应
返回 object: "list";data 为任务对象数组,has_more 表示是否有后续结果。
| 字段 | 说明 |
|---|---|
id |
任务 ID。 |
created_at |
任务创建时的 Unix 秒级时间戳。 |
error |
失败详情,可为结构化对象、其他值或 null。对象包含机器可读的 code、人类可读的 message,以及可为空的参数名 param。 |
fine_tuned_model |
微调后模型的名称,任务运行时可为 null。 |
finished_at |
完成时间,Unix 秒级时间戳,任务运行时可为 null。 |
model |
用于微调的基础模型。 |
object |
固定为 fine_tuning.job。 |
organization_id |
任务所属组织 ID。 |
result_files |
结果文件 ID 数组,可通过读取文件内容访问。 |
seed |
用于任务的整数随机种子,可为 null。 |
status |
任务状态。可能为 validating_files、queued、running、pausing、paused、succeeded、failed 或 cancelled。 |
trained_tokens |
处理的计费词元总数,运行时可为 null。 |
training_file |
训练文件 ID。 |
validation_file |
验证文件 ID,可为 null。 |
estimated_finish |
可选的预估完成时间,单位为 Unix 秒,未运行时可为 null。 |
hyperparameters |
可选的监督微调超参数,可为 null。包含 batch_size、learning_rate_multiplier、n_epochs。 |
integrations |
可选的外部集成列表,可为 null。 |
metadata |
可选的键值对,可为 null。 |
method |
可选的训练方式配置,可为 null。类型包括 supervised、dpo 与 reinforcement。 |
请求示例
## 先设置 API 密钥,并按请求需要替换示例中的 ID。
curl -X GET "https://api.openai.com/v1/fine_tuning/jobs" \
-H "Authorization: Bearer $OPENAI_API_KEY"
官方接口定义提供完整的嵌套字段、类型约束及更多响应示例。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: