Query fine-tuning task details

page_no

Integer

Query

No

Default value: 1.

page_size

Integer

Query

No

Default value: 10. Maximum: 1000. Minimum: 1.

model

String

Query

No

The model ID. If you specify this parameter, only fine-tuning jobs based on this model are listed.

job_id

String

URL path

Yes

The ID of the fine-tuning job to query. This is the job_id returned in the response parameters for creating a fine-tuning job.

request_id

String

The ID of the request.

output

Object

The details of the model fine-tuning job.

output.job_id

String

The ID of the model fine-tuning job. You can use this ID to query the job status.

Generation rule: ft-{yyyyMMddHHmm}-{4-digit-uuid}.

output.jobs_name

String

Same as output.job_id.

output.status

String

The job status of the model fine-tuning job.

output.finetuned_output

String

This parameter is returned only when the job status is SUCCEEDED. The value is the ID of the fine-tuned model.

output.model

String

The ID of the model used for the model fine-tuning job.

output.base_model

String

The ID of the foundation model that corresponds to the model used for the model fine-tuning job.

For example, the foundation model for the model fine-tuning job ft-202410291653-1c7f is qwen3-14b.

output.training_file_ids

Array

This field is retained for compatibility. For new jobs, this parameter always returns an empty array. Use training_datasets instead.

output.validation_file_ids

Array

This field is retained for compatibility. For new jobs, this parameter always returns an empty array. Use validation_datasets instead.

output.training_datasets

Array of Dataset

A list of training datasets.

output.validation_datasets

Array of Dataset

A list of test datasets.

output.hyper_parameters

Object

The explicitly declared hyperparameters.

output.training_type

String

The model fine-tuning method.

output.create_time

String

The time when the model fine-tuning job was created.

output.workspace_id

String

The ID of the workspace to which the model fine-tuning job belongs.

output.user_identity

String

The UID of the Alibaba Cloud account to which the model fine-tuning job belongs.

output.modifier

String

The UID of the account that last modified the model fine-tuning job. For example, if a RAM user cancels the job, the UID of the RAM user is returned in this field.

output.creator

String

The UID of the user who created the model fine-tuning job.

output.end_time

String

The time when the model fine-tuning job ended. This parameter is returned when the job status is SUCCEEDED, FAILED, or CANCELED.

output.group

String

The type of the model fine-tuning job.

output.usage

Integer

The number of tokens consumed by the model fine-tuning job. For the billing formula, see Billing items. This parameter is returned when the job status is SUCCEEDED or CANCELED.

output.output_cnt

Integer

The number of checkpoints that the job has generated. This parameter is returned only for models that support multiple checkpoint outputs, such as cosyvoice-v3-flash. To obtain a detailed list of checkpoints, you can call the Query Checkpoint API.

output.max_output_cnt

Integer

The maximum number of checkpoints that a single job can generate. If the value of output_cnt exceeds this limit, the excess checkpoints are truncated based on fine-tuning sufficiency. This parameter is returned only for models that support multiple checkpoint outputs.

job_id

String

Path

Yes

The ID of the fine-tuning job whose logs you want to retrieve. You can obtain this ID by calling the Create training job or List training jobs operation.

offset

Number

Query

No

Skips the first offset lines of the output and starts reading from the offset+1 line. This value must not be greater than the total number of output lines. Otherwise, no output is returned. The default value is 0.

line

Number

Query

No

Reads the number of output lines specified by line, starting from the line at offset+1. If the number of available lines is less than the value of line, the actual number of available lines is returned. The default value is 100. The maximum is 1000.

request_id

String

The ID of the request.

output

Object

The query results.

output.total

Integer

The total number of log lines.

output.logs

Array

The returned log entries.

job_id

String

URL path

Yes

The ID of the fine-tuning job to cancel. You can obtain this ID by calling the Create training job or List training jobs operation.

request_id

String

The ID of the request.

output

Object

The details returned for the cancel operation.

job_id

String

URL path

Yes

The ID of the fine-tuning job to delete. You can obtain this ID by calling the Create training job or List training jobs operation.

request_id

String

The ID of the request.

output

Object

The details returned for the delete operation.

code

String

The error code.

NotFound

request_id

String

The unique system code for the request.

6332fb02-3111-43f0-bf79-f9e8c5ffa7f9

message

String

The error message.

job {job_id} not found.

400

InvalidParameter

Missing training files

A parameter is invalid. For example, a parameter is missing or has an incorrect format.

Correct the parameter based on the error message.

400

UnsupportedOperation

The fine-tune job can not be deleted because it is succeeded, failed, or canceled

The operation cannot be performed on the resource because the resource is in a specific state.

Wait for the resource to enter an operable state before performing the operation.

400

UnsupportedOperation

The fine-tune job can not be canceled because it is succeeded or failed

The operation cannot be performed on the resource because the resource is in a specific state.

Wait for the resource to enter an operable state before performing the operation.

404

NotFound

job {job_id} not found.

The specified resource does not exist.

Verify that the resource ID is correct.

409

Conflict

Model instance 'xxxxx' already exists. Please specify a suffix.

A deployed model instance named xxxxx already exists. Specify a suffix to distinguish it.

Specify a unique suffix for the deployment.

429

Throttling

• Too many fine-tuning jobs are running. Please try again later.

• Only 20 running or succeeded fine-tuning jobs are allowed per user.

The resource creation triggered a platform limit.

• Delete models that are no longer in use.

500

InternalError

Internal server error!

An internal error occurred.

Record the request_id and submit a ticket to Alibaba Cloud for troubleshooting.