You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

请输入
  • 文档首页
    • 火山方舟管控面 API管理模型精调获取模型调优任务信息
复制全文
下载 pdf
我的收藏
管理模型精调
获取模型调优任务信息
复制全文
下载 pdf
我的收藏
获取模型调优任务信息
POST https://ark.cn-beijing.volcengineapi.com/?Action=GetModelCustomizationJob&Version=2024-01-01​
获取模型训练任务信息​
说明​
  • Status.Phase 反映任务当前阶段，常见取值包括 Queue（排队中）、Running（运行中）、Completed（已完成）、Failed（失败）、Cancelled（已取消）等。​
  • 失败任务可通过 Status.Resumable 判断是否可恢复；若为 true，可调用 ResumeModelCustomizationJob 接口重试。​
  • Outputs 数组按训练 Checkpoint 顺序列出产物；状态为 Available 的产物可发布为定制模型，Exported 表示已发布，Expired 表示已过期。​
鉴权​
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
Id string 必选 | 模型调优任务 ID​
​
​
响应参数​
BillingMethod string | 计费方式​
​
CreateTime string | 创建时间​
​
CustomizationType string | 训练类型​
​
CustomRLPipelineConfig object | RL 流水线配置​
​
CustomTLSConfig object | 自定义日志​
​
Data object | 数据集配置​
​
DebugConfig object | 调试配置​
​
Description string | 任务描述​
​
EnableTrajectory boolean | 是否启用训练轨迹​
​
ExplainabilityTLSConfig object | 可解释性日志​
​
Hyperparameters object[] | 超参数列表​
​
Id string | 任务 ID​
​
ModelReference object | 基础模型​
​
Name string | 任务名称​
​
OutputConfig object | 产物输出​
​
Outputs object[] | 产物列表​
​
ProjectName string | 所属项目​
​
PublishedOutputCount integer | 已发布数​
​
Reason string | 失败原因​
​
Resource object | 资源配置​
​
SaveModelLimit integer | 保存模型上限​
​
Status object | 任务状态​
​
Tags object[] | 标签列表​
​
TotalOutputCount integer | 产物总数​
​
TraceTLSConfig object | Trace 日志​
​
TrainingMetrics object[] | 训练指标​
​
TrainType string | 训练任务类型​
​
TrajectoryTLSConfig object | Trajectory 日志​
​
UpdateTime string | 更新时间​
​
ValidationMetrics object[] | 验证指标​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetModelCustomizationJob&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "Id": "mcj-20240101000000-a1b2cr"
}
'

Response

{
	"ResponseMetadata": {
		"RequestId": "2025011511564424916310121745440A",
		"Action": "GetModelCustomizationJob",
		"Version": "2024-01-01",
		"Service": "ark",
		"Region": "cn-beijing"
	},
	"Result": {
		"CreateTime": "2024-04-01T11:54:41Z",
		"CustomizationType": "FinetuneLoRA",
		"Data": {
			"TrainingSet": {
				"TosBucket": "ark-auto-2100466578-cn-beijing-default",
				"TosPaths": [
					"model-customization-job-training-set/1740646772293/train_5k.jsonl"
				]
			},
			"EncryptionKeyringType": "ManagedKeyring",
			"KMSTrn": "trn:kms:cn-beijing:2100466578:keyrings/managed_ark_keyring/keys/modelcustomization"
		},
		"Id": "mcj-20240401114541-5gzd8",
		"Hyperparameters": [
			{
				"Name": "epoch",
				"Value": "6"
			},
			{
				"Name": "learning_rate",
				"Value": "0.00001"
			}
		],
		"Description": "这是一个测试任务",
		"ModelReference": {
			"FoundationModel": {
				"Name": "doubao-seed-2-0-pro",
				"ModelVersion": "260215"
			}
		},
		"Outputs": [{
			"Index": 1,
			"Name": "global_step_1",
			"Status": "Exported"
		}],
		"ProjectName": "default",
		"Name": "测试任务",
		"PublishedOutputCount": 1,
		"Reason": "",
		"SaveModelLimit": 1,
		"Status": {
			"Phase": "Completed",
			"PhaseTime": "2024-04-04T07:04:29Z",
			"RetryLimit": 1
		},
		"Tags": [{
			"Key": "sys:ark:createdBy",
			"Value": "IAMUser/23454321/test.user@bytedance.com"
		}],
		"TotalOutputCount": 1,
		"UpdateTime": "2024-04-04T07:04:29Z"
	}
}
最近更新时间：2026.09.04 20:18:47
这个页面对您有帮助吗？
有用
有用
无用
无用