创建一个图像生成的模型微调训练任务。数据集支持通过API上传数据集或OSS挂载。
适用范围
- 适用地域：本文描述的功能仅在华北2（北京）地域可用，且必须使用该地域的API Key。
- 开通账号权限：若使用阿里云子账号（RAM用户），需要为子账号授予模型调用、训练和部署权限。
- 配置环境变量：已成功获取 API Key，并配置到环境变量。
- 准备工作：已阅读图像生成模型调优，了解支持微调的模型、微调步骤、数据格式以及计费说明。
创建微调任务
- 华北2（北京）
POST https://dashscope.aliyuncs.com/api/v1/fine-tunesWindows CMD 请将$DASHSCOPE_API_KEY替换为%DASHSCOPE_API_KEY%，PowerShell请替换为$env:DASHSCOPE_API_KEY
请求参数请求头（Headers）Content-Typestring （必选）固定值：application/jsonAuthorization string （必选）API Key鉴权，格式为Bearer sk-xxxx。请求体（Request Body）modelstring （必选）指定微调所用的基准模型。
array[string] （条件必选）训练集文件ID数组，可传入多个ID。与 training_datasets 二选一，若使用 training_datasets 则无需传此参数。文件ID通过上传文件 API 获取。validation_file_ids array[string] （可选）验证集文件ID数组，可传入多个ID。与 validation_datasets 二选一，若使用 validation_datasets 则无需传此参数。若两者均不提供，系统会从训练集中自动划分。文件ID通过上传文件 API 获取。training_type string （必选）微调类型，当前仅支持efficient_sft（LoRA高效微调）。hyper_parameters object （可选）超参数配置。初次训练时，推荐使用默认的超参数。若模型效果不佳或训练不收敛，可以尝试调整 max_steps 或 learning_rate 等参数。
超参数属性 max_steps int （必选）训练总步数。控制训练时长的核心参数。推荐值：800。max_steps 决定训练迭代次数，max_token_length 决定每步处理的数据量。建议不少于 500 步以确保模型充分收敛；大数据集可适当增加步数。eval_steps int （必选）验证间隔。推荐值：200。取值需≥0。训练期间每隔多少个 steps 进行一次验证评估，用于阶段性评估模型训练效果。同时保存当前 step 的模型文件。learning_rate float （必选）学习率。推荐值：3e-5。控制模型权重更新的幅度。过高可能导致模型变差，过低则变化不明显。generation_type string （必选）生成模式。决定训练数据格式和推理方式。可选值：
string （必选）训练图片的最大分辨率。设置训练集中图片分辨率的像素总数（宽×高）上限，系统仅对超过该值的图片进行缩放处理，未超限的图片保持原样。建议三个分辨率参数（max_pixels、max_token_length、val_img_size）保持一致。
string （必选）验证图生成分辨率。训练过程中验证评估时生成图片的目标分辨率。可选值同 max_pixels。推荐值：文生图 2k，图生图 1k。max_token_length string （必选）每步训练的最大 Token 长度，影响单步计算量与计费。与 max_steps 共同控制训练过程：max_steps 决定迭代次数，max_token_length 决定每步处理的数据量。可选值：
float （必选）梯度裁剪。推荐值：0.5。对所有可训练参数做全局梯度范数裁剪的阈值，防止梯度爆炸。设为 -1 表示不裁剪。weight_decay float （必选）权重衰减。推荐值：0.02。AdamW 解耦式权重衰减系数，对所有可训练参数生效，用于正则化防止过拟合。lora_rank int （必选）LoRA 低秩矩阵的维数。推荐值：32。该值决定了微调参数量的大小。数值越大，模型拟合能力越强，但训练速度会变慢。取值必须为2n（如 16、32、64）。save_total_limit int （可选）Checkpoint 保存数量上限。推荐值：10。限制最多保存的模型数量。系统将始终只保存训练生成的最后 N 个 Checkpoint。split float （可选）训练集划分比例。推荐值：0.9。取值范围为 (0, 1)。仅在未指定validation_file_ids或validation_datasets时生效。此参数用于从训练集中自动按比例拆分出验证集。例如，0.9表示90%训练集，10%验证集。Array of Dataset （条件必选）训练集文件列表。与 training_file_ids 二选一，若使用 training_file_ids 则无需传此参数。
Dataset 结构 data_source_type string （必选）数据源类型，可选值：
object （条件必选）数据源类型为 oss_mount 时必填。OSS 挂载信息。
属性 region string （必选）要挂载的 OSS Bucket 所属地域。支持北京（cn-beijing）和新加坡（ap-southeast-1）。bucket string （必选）要挂载的 OSS Bucket 名称。file_path string （必选）要挂载的 OSS 文件路径（object key）。对包含多个文件的数据集，使用其 data.jsonl 的文件路径。与使用 file_id 的方式不同，需要将未经压缩的数据集文件夹整体上传到 OSS，不支持 zip 文件。string （条件必选）数据源类型为 file_id 时必填。文件 ID，由上传文件 API 产生。Array of Dataset （可选）验证集文件列表。结构同training_datasets。与 validation_file_ids 二选一。若两者均不提供，系统会从训练集中自动划分。job_name string （可选）调优任务名称。model_name string （可选）调优完成后的模型名称。 |
响应参数request_idstring请求的唯一标识符。output object任务详情。
属性 job_id string模型微调任务唯一标识，用于查询任务详情、日志、取消或删除任务。生成规则：ft-{yyyyMMddHHmm}-{4位uuid}。job_name string模型微调任务名称。status string微调训练任务的状态：
string微调后产出的新模型ID，部署和调用时需要用到。任务状态为 SUCCEEDED 时返回。model string使用的基准模型。base_model string使用的基准模型。training_file_ids array兼容旧版字段，新任务始终返回空数组，请使用 training_datasets。training_datasets Array of Dataset训练数据集列表。validation_file_ids array兼容旧版字段，新任务始终返回空数组，请使用 validation_datasets。validation_datasets Array of Dataset验证数据集列表。若未指定验证集，为空数组。hyper_parameters object实际使用的超参数。training_type string模型微调的训练方式。create_time string任务创建时间。end_time string任务结束时间。任务状态为 SUCCEEDED、FAILED 或 CANCELED 时返回。usage integer微调任务消耗的 Token 数。任务状态为 SUCCEEDED 或 CANCELED 时返回。workspace_id string阿里云百炼API Key所属的业务空间ID。请参见获取Workspace ID。user_identity string用户标识，阿里云账号ID。creator string创建人的阿里云账号ID。modifier string修改人的阿里云账号ID。group string模型微调任务分组。max_output_cnt integer训练期间最多保存的 checkpoint 数量。等同于超参数 save_total_limit 的值。string错误码。调用失败时返回。请参见下方错误码表。message string错误详情描述。调用失败时返回。 |
重点关注： output.job_id（任务ID）、output.finetuned_output（微调后产出的新模型名称）。 |
错误码
如果调用失败并返回报错信息，请参见下表进行排查。
HTTP 状态码 | 错误码 | 解决方案 |
|---|---|---|
400 | InvalidParameter | 参数错误，缺少参数或者参数格式问题等。根据错误信息修正您的参数。 |
400 | UnsupportedOperation | 当资源处于特定状态时，无法对其进行操作。待要操作的资源到达可操作状态时再进行操作。 |
404 | NotFound | 要查询/操作的资源不存在。检查资源ID是否错误。 |
409 | Conflict | 已存在同名部署实例，需要指定后缀进行区分。 |
429 | Throttling | 资源的创建触发平台限制。删除不再使用的模型。如您确实需要提高调优任务的并发量或保留更多调优成功的模型，请联系商务经理。 |
500 | InternalError | 内部错误。记录 request_id，通过工单联系阿里云工程师进行排查。 |