ListModelCustomizationJobs - 获取模型调优任务列表--火山方舟-火山引擎

文档中心

火山方舟

管理模型调优任务

ListModelCustomizationJobs - 获取模型调优任务列表

获取模型调优任务列表

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	ListModelCustomizationJobs	要执行的操作，取值：ListModelCustomizationJobs。
Version	String	是	2024-01-01	API的版本，取值：2024-01-01。
PageNumber	Integer	否	1	翻页页数
PageSize	Integer	否	1	翻页大小
SortBy	String	否	CreateTime	排序字段
SortOrder	String	否	Desc	排序顺序（倒序或顺序）
Filter	Object	否	-	模型调优任务过滤条件
ProjectName	String	否	default	资源所属的项目名称，默认值为default。若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看文档。
TagFilters	Array of Object	否	-	按 Tag 过滤

返回参数

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

参数	类型	示例值	描述
TotalCount	Integer	10	符合查询条件的对象的总数
PageNumber	Integer	1	请求时的 PageNumber
PageSize	Integer	10	请求时的 PageSize
Items	Array of Object	-	查询结果

请求示例

{
    "PageNumber": 1,
    "PageSize": 10,
    "ProjectName": "default",
    "TagFilters": [
        {
            "Key": "sys:ark:createdBy",
            "Values": ["IAMUser/23454321/test.user@bytedance.com"]
        }
    ],
    "Filter": {
        "Ids": ["mcj-20240101000000-a1b2c"]
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240101000000046C7CCC3CCCE87016E3",
        "Action": "ListModelCustomizationJobs",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "TotalCount": 1,
        "PageNumber": 1,
        "PageSize": 10,
        "Items": [
            {
                "Id": "mcj-20240101000000-a1b2c",
                "Name": "测试任务",
                "Description": "这是一个测试任务",
                "Tags": [
                    {
                        "Key": "sys:ark:createdBy",
                        "Value": "IAMUser/23454321/test.user@bytedance.com"
                    }
                ],
                "ProjectName": "default",
                "CustomizationType": "FinetuneLoRA",
                "ModelReference": {
                    "FoundationModel": {
                        "Name": "skylark2-lite-8k",
                        "ModelVersion": "1.0",
                        "ConfigurationId": "fmvc-20240101000000-a1b2c"
                    }
                },
                "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"
                        ]
                    }
                },
                "Status": {
                    "Phase": "Completed",
                    "PhaseTime": "2024-01-01T00:00:00Z"
                },
                "CreateTime": "2024-01-01T00:00:00Z",
                "UpdateTime": "2024-01-01T00:00:00Z"
            }
        ]
    }
}

错误码

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

状态码	错误码	错误信息	说明
400	MissingParameter.{{Parameter}}	The required parameter {{Parameter}} is missing.	缺少必要的请求参数。请确认请求参数后重试。
400	InvalidParameter.{{Parameter}}	The specified parameter {{Parameter}} is invalid.	请求参数值不合法。请检查参数值的正确性后重试。
500	InternalError	The request has failed due to an unknown error.	未知错误，请稍后重试。如果多次尝试仍失败，请提交工单。

最近更新时间：2025.06.20 20:04:26

这个页面对您有帮助吗？

有用

无用

火山方舟

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码