OpenAI 创建微调任务

POST /v1/fine_tuning/jobs

使用训练数据集创建微调任务。接口返回已入队的任务；训练完成后可查询生成的模型名称。

自助微调已限制新建任务。按官方时间表，2026 年 7 月 2 日起，过去 60 天内未使用微调模型做过推理的组织无法创建任务；2027 年 1 月 6 日起，现有活跃客户也将无法新建。已微调模型的推理随对应基础模型的生命周期结束。详见官方弃用时间表。

请求体

内容类型为 application/json。

字段	说明
`model`	基础模型 ID。可用模型取决于组织权限和微调方式。
`training_file`	已上传的训练文件 ID。文件为 JSONL，上传用途为 fine-tune。
`hyperparameters`	可选。旧式超参数配置包含 batch_size、learning_rate_multiplier、n_epochs；可使用 method 中的对应配置。
`integrations`	可选，可为 null。用于配置 Weights & Biases 等文档列出的集成。
`metadata`	可选，可为 null。最多 16 组键值对，键最多 64 字符，值最多 512 字符。
`method`	可选。type 选择 supervised（监督微调）、dpo（直接偏好优化）或 reinforcement（强化微调），在对应同名字段中填写该方法的配置。
`seed`	可选，范围为 0 到 2147483647。省略时由系统生成。
`suffix`	可选，可为 null，非空后缀长度为 1–64 字符。
`validation_file`	可选，可为 null。文件为 JSONL，上传用途为 fine-tune。验证数据与训练数据不得重叠。

响应

字段	说明
`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 POST "https://api.openai.com/v1/fine_tuning/jobs" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"REPLACE_WITH_BASE_MODEL","training_file":"file-example"}'

官方接口定义提供完整的嵌套字段、类型约束及更多响应示例。