You need to enable JavaScript to run this app.
导航
CreateModelCustomizationJob - 创建模型调优任务
最近更新时间:2024.12.04 15:14:14首次发布时间:2024.05.15 01:48:34

创建模型调优任务

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

CreateModelCustomizationJob

要执行的操作,取值:CreateModelCustomizationJob。

Version
String

2024-01-01

API的版本,取值:2024-01-01。

Data
Object

-

模型微调数据集

ModelReference
Object

-

微调基于的模型,必须在定制模型和基座模型中二选一

Hyperparameters
Array of Object

-

训练超参配置。超参数组中每一项的 Name 不能重复。

Name
String

TestName

模型调优任务名称

Description
String

TestDescription

模型调优任务描述

ProjectName
String

default

项目名

CustomizationType
String

FinetuneSft

训练类型,取值范围:FinetuneSft,FinetuneLoRA,Pretrain,DPOLoRA

Tags
Array of Object

-

标签信息配置

SaveModelLimit
Integer

1

SaveModel 数量的最大限制

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
Id
String

mcj-test-id

创建好的模型调优任务的ID

请求示例

{
    "Name": "测试任务",
    "Description": "这是一个测试任务",
    "Tags": [
        {
            "Key": "test_key",
            "Value": "test_value"
        }
    ],
    "ProjectName": "default",
    "CustomizationType": "FinetuneLoRA",
    "ModelReference": {
        "FoundationModel": {
            "Name": "skylark2-lite-8k",
            "ModelVersion": "1.0"
        }
    },
    "Hyperparameters": [
        {
            "Name": "epoch",
            "Value": "6"
        },
        {
            "Name": "learning_rate",
            "Value": "0.00001"
        }
    ],
    "SaveModelLimit": 1,
    "Data": {
        "TrainingSet": {
            "TosBucket": "ark-auto-created-required-2100000000-cn-beijing",
            "TosPaths": [
                "model-customization-job-upload-set/1712561985763/test.jsonl"
            ]
        }
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240101000000046C7CCC3CCCE87016E3",
        "Action": "CreateModelCustomizationJob",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "mcj-20240101000000-a1b2c"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
MissingParameter.{{Parameter}}
The required parameter {{Parameter}} is missing.

缺少必要的请求参数。请确认请求参数后重试。

400
InvalidParameter.{{Parameter}}
The specified parameter {{Parameter}} is invalid.

请求参数值不合法。请检查参数值的正确性后重试。

400
Duplicate.Tags.Key
The specified object of tags contains duplicate keys.

对象的标签存在重复Key。

403
OperationDenied.ConflictedValidationSet
Operation is denied because it is not supported to configure ValidationSet and ValidationPercentage at the same time.

无法同时上传验证集和设置训练集取样为验证集百分比,不支持该操作。

403
OperationDenied.PermissionDenied
Operation is denied because You are not permitted to access the specified configuration of the FoundationModel.

您没有权限访问基础模型的配置,不支持该操作。

403
OperationDenied.UnsupportedCustomizationType
Operation is denied because The specified CustomizationType is not supported by the CustomModel.

模型不支持该训练方法,不支持该操作。

403
OperationDenied.CustomizationNotSupported
Operation is denied because The specified version of the FoundationModel is not configured for the specified type of customization.

基础模型的版本不支持该训练方法,不支持该操作。

403
OperationDenied.ServiceNotOpen
Operation is denied because The model service is unavailable, please go to the Volcano Ark console activation management page to activate the corresponding model service, or submit a work order to contact us.

模型服务不可用,不支持该操作。请前往火山方舟控制台激活模型服务,或提交工单联系我们。

403
OperationDenied.ServiceOverdue
Operation is denied because Your account balance is overdue, please go to the Volc Trading Center to recharge in order to continue using the service.

您的账单已逾期,不支持该操作。请前往火山费用中心充值。

500
InternalError
The request has failed due to an unknown error.

未知错误,请稍后重试。如果多次尝试仍失败,请提交工单。