Fine-tune job object-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Describes the attributes and structure of a fine-tune job object.

The model fine-tuning API is currently available only in the China (Beijing) region. To perform model fine-tuning in other regions, use the Model Studio console for that region.

The fine-tune job object represents a model fine-tuning task. It is returned by API operations such as Create Fine-tune Job, Get Fine-tune Job Details, and List Fine-tune Jobs.

Fields

Parameter	Type	Description
request_id	String	The unique ID of the request.
output	Object	Contains detailed information about the fine-tune job.
output.job_id	String	A unique identifier for the fine-tune job. You can use this ID to query the job status. The ID is generated in the following format: `ft-{yyyyMMddHHmm}-{4-digit uuid}`.
output.jobs_name	String	Same as `output.job_id`.
output.status	String	The status of the fine-tune job.
output.finetuned_output	String	The ID of the fine-tuned model. This field is returned only when the job status is `SUCCEEDED`.
output.model	String	The ID of the model used for the fine-tune job.
output.base_model	String	The ID of the base model used for the fine-tune job. For example, the base model used by the fine-tune job `ft-202410291653-1c7f` is `qwen3-14b`.
output.training_file_ids	Array	A list of training file IDs.
output.validation_file_ids	Array	A list of validation file IDs.
output.hyper_parameters	Object	The explicitly declared hyperparameters for the job.
output.training_type	String	The fine-tuning method.
output.create_time	String	The time the fine-tune job was created.
output.workspace_id	String	The ID of the workspace containing the fine-tune job.
output.user_identity	String	The UID of the main account that owns the fine-tune job.
output.modifier	String	The UID of the account that last modified the fine-tune job. For example, if a sub-account cancels the job, the sub-account UID appears here.
output.creator	String	The UID of the user who created the fine-tune job.
output.end_time	String	The time the fine-tune job ended. This field is returned only when the job status is `SUCCEEDED`, `FAILED`, or `CANCELED`.
output.group	String	The job type for model fine-tuning.
output.usage	Integer	The number of tokens consumed by the fine-tune job. For the billing formula, see Billing. This field is returned only when the job status is `SUCCEEDED` or `CANCELED`.
output.output_cnt	Integer	The number of checkpoints generated by the job. This field is returned only for models that support multiple checkpoint outputs (for example, `cosyvoice-v3-flash`). To get a detailed list of checkpoints, call the List Checkpoints API.
output.max_output_cnt	Integer	The maximum number of checkpoints that a single job can generate. If `output_cnt` exceeds this limit, the excess checkpoints are truncated based on fine-tuning completeness. This field is returned only for models that support multiple checkpoint outputs.

Fine-tune job status

Job status	Description
PENDING	The job has been created and is waiting to start.
QUEUING	The job is in the queue. Only one fine-tune job can run at a time.
RUNNING	The job is running.
CANCELING	The job is being canceled.
SUCCEEDED	The job completed successfully.
FAILED	The job failed.
CANCELED	The job was canceled.

Request error codes

The following information is returned when a request fails.

Field	Type	Description	Example
code	String	The error code.	NotFound
request_id	String	The unique ID generated for the request.	6332fb02-3111-43f0-bf79-f9e8c5ffa7f9
message	String	The error message.	Not Found!

Example error response

{
  "code": "NotFound",
  "request_id": "BE213CDD-8A5C-59EE-9A67-055EAB0CB59B",
  "message": "Not Found!"
}

List of error codes

HTTP status code	Error code	Example message	Description	Actions
400	InvalidParameter	Missing training files	A parameter is invalid, missing, or in an incorrect format.	Correct the parameters based on the error message.
400	UnsupportedOperation	The fine-tune job cannot be deleted because it has succeeded, failed, or been canceled.	The operation cannot be performed because the resource is in a specific state.	Wait until the resource enters an operable state, and then try again.
404	NotFound	Not Found!	The requested resource does not exist.	Verify that the resource ID is correct.
409	Conflict	Model instance xxxxx already exists, please specify a suffix	A model instance with the specified name already exists, causing a name conflict.	Specify a unique suffix for the deployment.
429	Throttling	Too many fine-tune jobs are running. Please retry later. A user can have a maximum of 20 running or succeeded fine-tune jobs.	The request exceeds a platform limit.	Delete models that you no longer need. If you need higher fine-tune job concurrency or to retain more successfully fine-tuned models, contact your account manager.
500	InternalError	Internal server error!	An internal error occurred.	Record the `request_id` and contact Alibaba Cloud support by submitting a ticket.