codecamp

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"}'

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

OpenAI 取消微调任务
OpenAI 列出微调任务
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

其他能力与进阶指南

Embeddings 接口参考

审计日志接口参考

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }