Consultar detalles de la tarea de ajuste fino

Requisitos previos

Región aplicable: Las funciones descritas en este tema están disponibles únicamente en la región de China (Pekín) y debe utilizar la API Key de esa región.
Región aplicable: Las funciones descritas en este tema están disponibles únicamente en la región de Singapur y debe utilizar la API Key de esa región.
Ha obtenido una API Key correctamente y la ha configurado en una variable de entorno.
Ha creado un trabajo de ajuste fino llamando a la operación Crear trabajo de ajuste fino.

Consultar el estado del trabajo de ajuste fino

Consulte la información detallada y el estado de ejecución de un trabajo de ajuste fino especificado.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}

Ejemplo de solicitud

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parámetros de solicitud

Campo	Tipo	Paso de parámetros	Obligatorio	Descripción
job_id	String	Url Path	Sí	El ID del trabajo de ajuste fino que se va a consultar. Es el job_id de los parámetros de respuesta para crear un trabajo de ajuste fino.

Respuesta de ejemplo

Modelo de generación de texto
Modelo de generación de video
Modelo de generación de imágenes

{
    "request_id": "c59b2145-a93c-4e00-b610-4d7cc5c521a2",
    "output": {
        "job_id": "ft-202410291653-1c7f",
        "job_name": "ft-202410291653-1c7f",
        "status": "SUCCEEDED",
        "finetuned_output": "qwen3-14b-suffix-ft-202410291653-1c7f",
        "model": "qwen3-14b",
        "base_model": "qwen3-14b",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {
                "data_source_type": "file_id",
                "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"
            }
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "n_epochs": 3,
            "batch_size": 32,
            "max_length": 8192,
            "learning_rate": "1.6e-5",
            "lr_scheduler_type": "linear",
            "split": 0.9
        },
        "training_type": "sft",
        "create_time": "2024-10-29 16:53:53",
        "workspace_id": "llm-v71tlv***",
        "user_identity": "1396993924585947",
        "modifier": "1396993924585947",
        "creator": "1396993924585947",
        "end_time": "2024-10-29 17:11:26",
        "group": "llm",
        "usage": 279808
    }
}

Tenga en cuenta output.status (SUCCEEDED indica que el entrenamiento ha finalizado) y output.usage (el número total de tokens consumidos por el entrenamiento).

{
    "request_id": "9bbb953c-bef2-4b59-9fc5-xxxxxxxxx",
    "output": {
        "job_id": "ft-202511111122-xxxx",
        "status": "SUCCEEDED",
        "finetuned_output": "wan2.5-i2v-preview-ft-202511111122-xxxx",
        "model": "wan2.5-i2v-preview",
        "base_model": "wan2.5-i2v-preview",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {
                "data_source_type": "file_id",
                "file_id": "xxxxxxxxxxxx"
            }
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "n_epochs": 400,
            "learning_rate": 2e-05,
            "split": 0.9,
            "eval_epochs": 50
        },
        "training_type": "efficient_sft",
        "create_time": "2025-11-11 11:22:22",
        "end_time": "2025-11-11 16:49:01",
        "usage": 432000,
        "output_cnt": 8
    }
}

{
    "request_id": "03d738f5-3720-90b0-9c7b-xxxxxxxxx",
    "output": {
        "job_id": "ft-202606030110-xxxx",
        "status": "SUCCEEDED",
        "finetuned_output": "wan2.7-image-pro-ft-202606030110-xxxx",
        "model": "wan2.7-image-pro",
        "base_model": "wan2.7-image-pro",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {
                "data_source_type": "file_id",
                "file_id": "xxxxxxxxxxxx"
            }
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "max_steps": 800,
            "learning_rate": 3e-05,
            "eval_steps": 200,
            "max_token_length": "2k",
            "max_pixels": "2k",
            "val_img_size": "2k",
            "generation_type": "t2i",
            "lora_rank": 32
        },
        "training_type": "efficient_sft",
        "create_time": "2026-06-03 01:10:47",
        "end_time": "2026-06-03 01:38:53",
        "usage": 10273216,
        "output_cnt": 1
    }
}

Parámetros de respuesta

Nombre del parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud.
output	Object	Los detalles del trabajo de ajuste fino.
output.job_id	String	El ID del trabajo de ajuste fino. Puede utilizar este ID para consultar el estado del trabajo posteriormente. Regla de generación: `ft-{yyyyMMddHHmm}-{4-digit uuid}`.
output.jobs_name	String	Igual que `output.job_id`.
output.status	String	El estado del trabajo de este trabajo de ajuste fino.
output.finetuned_output	String	Este parámetro aparece solo cuando el estado del trabajo de ajuste fino es SUCCEED. Devuelve el ID del modelo con ajuste fino.
output.model	String	El ID del modelo utilizado para el trabajo de ajuste fino.
output.base_model	String	El ID del modelo base que corresponde al modelo utilizado para el trabajo de ajuste fino. Por ejemplo, el modelo base utilizado por el trabajo de ajuste fino `ft-202410291653-1c7f` es `qwen3-14b`.
output.training_file_ids	Array	Un campo para compatibilidad. Los nuevos trabajos siempre devuelven un array vacío. Utilice training_datasets en su lugar.
output.validation_file_ids	Array	Un campo para compatibilidad. Los nuevos trabajos siempre devuelven un array vacío. Utilice validation_datasets en su lugar.
output.training_datasets	Array de Dataset	Una lista de conjuntos de datos de entrenamiento.
output.validation_datasets	Array de Dataset	Una lista de conjuntos de datos de prueba.
output.hyper_parameters	Object	Los hiperparámetros declarados explícitamente.
output.training_type	String	El método de ajuste fino.
output.create_time	String	La hora en que se creó el trabajo de ajuste fino.
output.workspace_id	String	El ID del espacio de trabajo al que pertenece el trabajo de ajuste fino.
output.user_identity	String	El UID de la cuenta principal a la que pertenece el trabajo de ajuste fino.
output.modifier	String	El UID de la cuenta que operó por última vez en el trabajo de ajuste fino. (Por ejemplo, si un usuario RAM cancela el trabajo, aquí se muestra el UID del usuario RAM.)
output.creator	String	El UID del usuario que creó el trabajo de ajuste fino.
output.end_time	String	La hora en que finalizó el trabajo de ajuste fino. Este parámetro aparece cuando el estado del trabajo es SUCCEED, FAILED o CANCELED.
output.group	String	El tipo de tarea del ajuste fino del modelo.
output.usage	Integer	El número de tokens (recuento) consumidos por el trabajo de ajuste fino. Para la fórmula de facturación, consulte Facturación. Este parámetro aparece cuando el estado del trabajo es SUCCEED o CANCELED.
output.output_cnt	Integer	El número de Checkpoints que ha generado el trabajo actual. Este parámetro se devuelve únicamente para modelos que admiten múltiples salidas de Checkpoint (como `cosyvoice-v3-flash`). Puede obtener la lista detallada de Checkpoints llamando a la operación Query Checkpoint.
output.max_output_cnt	Integer	El número máximo de Checkpoints que puede generar un solo trabajo. La parte de `output_cnt` que supera este límite se trunca según la suficiencia del ajuste fino. Este parámetro se devuelve únicamente para modelos que admiten múltiples salidas de Checkpoint.

Cancelar un trabajo de ajuste fino

Cancela un trabajo de ajuste fino en ejecución. Solo se pueden cancelar los trabajos en estado de ejecución.

Endpoint

POST https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/cancel

Ejemplo de solicitud

curl --location --request POST "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/cancel" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parámetros de solicitud

Campo	Tipo	Paso de parámetros	Obligatorio	Descripción
job_id	String	Url Path	Sí	El ID del trabajo de ajuste fino que se va a cancelar. Puede obtener este ID llamando a la operación crear trabajo de entrenamiento o listar trabajos de entrenamiento.

Respuesta de ejemplo

{
    "request_id": "670fca9d-48dd-4c5a-83e7-33bcc20420f8",
    "output": {
        "status": "success"
    }
}

Parámetros de respuesta

Nombre del parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud.
output	Object	Los detalles devueltos para la operación de cancelación.

Eliminar un trabajo de ajuste fino

Elimina el registro de un trabajo de ajuste fino especificado.

Endpoint

DELETE https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}

Ejemplo de solicitud

curl --location --request DELETE "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parámetros de solicitud

Campo	Tipo	Paso de parámetros	Obligatorio	Descripción
job_id	String	Url Path	Sí	El ID del trabajo de ajuste fino que se va a eliminar. Puede obtener este ID llamando a la operación crear trabajo de entrenamiento o listar trabajos de entrenamiento.

Respuesta de ejemplo

{
    "request_id": "7d7e1469-df77-4163-83ce-54425df744ed",
    "output": {
        "status": "success"
    }
}

Parámetros de respuesta

Nombre del parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud.
output	Object	Los detalles devueltos para la operación de eliminación.

Consultar la lista de trabajos de ajuste fino

Consulta la lista de trabajos de ajuste fino de la cuenta actual de forma paginada.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes

Ejemplo de solicitud

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes?model=qwen3-14b&page_no=2" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parámetros de solicitud

Nombre del parámetro	Tipo	Paso de parámetros	Obligatorio	Descripción
page_no	Integer	Consulta	No	Valor predeterminado: 1.
page_size	Integer	Consulta	No	Valor predeterminado: 10. Máximo: 1000. Mínimo: 1.
model	String	Consulta	No	El ID del modelo. Si especifica este parámetro, solo se listan los trabajos de ajuste fino basados en este modelo.

Respuesta de ejemplo

{
    "request_id": "2182ef64-6398-457b-b3f6-5fde5fd6b388",
    "output": {
        "page_no": 2,
        "page_size": 10,
        "total": 12,
        "jobs": [
            {
                "job_id": "ft-202410291653-1c7f",
                "job_name": "ft-202410291653-1c7f",
                "status": "SUCCEEDED",
                "finetuned_output": "qwen3-14b-suffix-ft-202410291653-1c7f",
                "model": "qwen3-14b",
                "base_model": "qwen3-14b",
                "training_file_ids": [],
                "validation_file_ids": [],
                "training_datasets": [
                    {
                        "data_source_type": "file_id",
                        "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"
                    }
                ],
                "validation_datasets": [],
                "hyper_parameters": {
                    "n_epochs": 3,
                    "batch_size": 32,
                    "max_length": 8192,
                    "learning_rate": "1.6e-5",
                    "lr_scheduler_type": "linear",
                    "split": 0.9
                },
                "training_type": "sft",
                "create_time": "2024-10-29 16:53:53",
                "workspace_id": "llm-v71tlv***",
                "user_identity": "1396993924585947",
                "modifier": "1396993924585947",
                "creator": "1396993924585947",
                "end_time": "2024-10-29 17:11:26",
                "group": "llm",
                "usage": 279808
            },
            {
                "job_id": "ft-202410291512-1851",
                "job_name": "ft-202410291512-1851",
                "status": "CANCELED",
                "model": "qwen3-14b",
                "base_model": "qwen3-14b",
                "training_file_ids": [],
                "validation_file_ids": [],
                "training_datasets": [
                    {
                        "data_source_type": "file_id",
                        "file_id": "86a9fe7f-dd77-43b0-9834-2170e12339ec"
                    },
                    {
                        "data_source_type": "file_id",
                        "file_id": "03ead352-6190-4328-8016-61821c23d4fc"
                    }
                ],
                "validation_datasets": [],
                "hyper_parameters": {
                    "n_epochs": 3,
                    "batch_size": 32,
                    "max_length": 8192,
                    "learning_rate": "1.6e-5",
                    "lr_scheduler_type": "linear",
                    "split": 0.9
                },
                "code": "1",
                "training_type": "sft",
                "create_time": "2024-10-29 15:12:00",
                "workspace_id": "llm-v71tlv***",
                "user_identity": "1396993924585947",
                "modifier": "1396993924585947",
                "creator": "1396993924585947",
                "end_time": "2024-10-29 15:16:00",
                "group": "llm",
                "usage": 0
            }
        ]
    }
}

Parámetros de respuesta

Nombre del parámetro Tipo Descripción

request_id String El ID de la solicitud.

output Object Los detalles devueltos para la consulta.

output.page_no Integer El número de página.

output.page_size Integer El número de entradas mostradas por página.

output.total Integer El número total de trabajos de ajuste fino.

output.jobs

Array

Los detalles de varios trabajos de ajuste fino.

Haga clic aquí para ver el objeto de detalles del trabajo de ajuste fino

Nombre del parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud.
output	Object	Los detalles del trabajo de ajuste fino.
output.job_id	String	El ID del trabajo de ajuste fino. Puede utilizar este ID para consultar el estado del trabajo posteriormente. Regla de generación: `ft-{yyyyMMddHHmm}-{4-digit uuid}`.
output.jobs_name	String	Igual que `output.job_id`.
output.status	String	El estado del trabajo de este trabajo de ajuste fino.
output.finetuned_output	String	Este parámetro aparece solo cuando el estado del trabajo de ajuste fino es SUCCEED. Devuelve el ID del modelo con ajuste fino.
output.model	String	El ID del modelo utilizado para el trabajo de ajuste fino.
output.base_model	String	El ID del modelo base que corresponde al modelo utilizado para el trabajo de ajuste fino. Por ejemplo, el modelo base utilizado por el trabajo de ajuste fino `ft-202410291653-1c7f` es `qwen3-14b`.
output.training_file_ids	Array	Un campo para compatibilidad. Los nuevos trabajos siempre devuelven un array vacío. Utilice training_datasets en su lugar.
output.validation_file_ids	Array	Un campo para compatibilidad. Los nuevos trabajos siempre devuelven un array vacío. Utilice validation_datasets en su lugar.
output.training_datasets	Array de Dataset	Una lista de conjuntos de datos de entrenamiento.
output.validation_datasets	Array de Dataset	Una lista de conjuntos de datos de prueba.
output.hyper_parameters	Object	Los hiperparámetros declarados explícitamente.
output.training_type	String	El método de ajuste fino.
output.create_time	String	La hora en que se creó el trabajo de ajuste fino.
output.workspace_id	String	El ID del espacio de trabajo al que pertenece el trabajo de ajuste fino.
output.user_identity	String	El UID de la cuenta principal a la que pertenece el trabajo de ajuste fino.
output.modifier	String	El UID de la cuenta que operó por última vez en el trabajo de ajuste fino. (Por ejemplo, si un usuario RAM cancela el trabajo, aquí se muestra el UID del usuario RAM.)
output.creator	String	El UID del usuario que creó el trabajo de ajuste fino.
output.end_time	String	La hora en que finalizó el trabajo de ajuste fino. Este parámetro aparece cuando el estado del trabajo es SUCCEED, FAILED o CANCELED.
output.group	String	El tipo de tarea del ajuste fino del modelo.
output.usage	Integer	El número de tokens (recuento) consumidos por el trabajo de ajuste fino. Para la fórmula de facturación, consulte Facturación. Este parámetro aparece cuando el estado del trabajo es SUCCEED o CANCELED.
output.output_cnt	Integer	El número de Checkpoints que ha generado el trabajo actual. Este parámetro se devuelve únicamente para modelos que admiten múltiples salidas de Checkpoint (como `cosyvoice-v3-flash`). Puede obtener la lista detallada de Checkpoints llamando a la operación Query Checkpoint.
output.max_output_cnt	Integer	El número máximo de Checkpoints que puede generar un solo trabajo. La parte de `output_cnt` que supera este límite se trunca según la suficiencia del ajuste fino. Este parámetro se devuelve únicamente para modelos que admiten múltiples salidas de Checkpoint.

Consultar los registros del trabajo de ajuste fino

Consulta los registros de entrenamiento de un trabajo de ajuste fino especificado.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/logs

Ejemplo de solicitud

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/logs?offset=10&line=10" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parámetros de solicitud

Campo	Tipo	Paso de parámetros	Obligatorio	Descripción
job_id	String	Url Path	Sí	El ID del trabajo de ajuste fino para el que se van a consultar los registros. Puede obtener este ID llamando a la operación crear trabajo de entrenamiento o listar trabajos de entrenamiento.
offset	Number	Consulta	No	Omite las primeras `offset` líneas de salida y comienza a leer desde la línea `offset+1`. El valor no puede superar el número total de líneas de salida existentes; de lo contrario, no se devuelve información de salida. El valor predeterminado es 0.
line	Number	Consulta	No	Lee `line` líneas de salida a partir de la línea `offset+1` (incluida). Si la salida de esta solicitud tiene menos de `line` líneas, se devuelve la salida real. El valor predeterminado es 100 y el límite superior es 1000.

Respuesta de ejemplo

{
    "request_id": "ce49b45d-fe46-474e-9e1b-3e7427ffdf5a",
    "output": {
        "total": 20,
        "logs": [
            "{'train_runtime': 216.3999, 'train_samples_per_second': 2.066, 'train_steps_per_second': 0.014, 'train_loss': 0.9122632344563802, 'epoch': 0.8571428571428571}",
            " Actual number of consumed tokens is 279808!",
            " Uploaded checkpoint!",
            " Fine-tune succeeded!",
            " use checkpoint-3 as final checkpoint",
            "2024-10-29 17:03:47,719 - INFO - transfer for inference succeeded, start to deliver it for inference",
            "2024-10-29 17:09:43,322 - INFO - start to save checkpoint",
            "2024-10-29 17:11:24,689 - INFO - finetune-job succeeded",
            "2024-10-29 17:11:25,130 - INFO - training usage 279808",
            "2024-10-29 17:11:25,175 - INFO - ##FT_COMPLETE##"
        ]
    }
}

Parámetros de respuesta

Nombre del parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud.
output	Object	Los detalles devueltos para la consulta.
output.total	Integer	El número total de líneas de registro.
output.logs	Array	Los registros de salida.

Respuestas de error

Respuesta de ejemplo

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

Parámetros de respuesta

Campo	Tipo	Descripción	Valor de ejemplo
code	String	El código de error.	NotFound
request_id	String	El código único del sistema para la solicitud.	6332fb02-3111-43f0-bf79-f9e8c5ffa7f9
message	String	El mensaje de error.	Not Found!

Cuando una solicitud falla, se pueden devolver los siguientes errores:

Código de estado HTTP	Código de error	Mensaje de error de ejemplo	Significado	Solución
400	InvalidParameter	Faltan archivos de entrenamiento	Un parámetro no es válido. Por ejemplo, falta un parámetro o tiene un formato incorrecto.	Corrija los parámetros según el mensaje de error.
400	UnsupportedOperation	El trabajo de ajuste fino no se puede cancelar porque se ha completado con éxito o ha fallado	La operación no se puede realizar en el recurso en su estado actual.	Realice la operación después de que el recurso entre en un estado operable.
400	UnsupportedOperation	El trabajo de ajuste fino no se puede eliminar porque se ha completado con éxito, ha fallado o se ha cancelado	La operación no se puede realizar en el recurso en su estado actual.	Realice la operación después de que el recurso entre en un estado operable.
404	NotFound	No encontrado.	El recurso que se va a consultar/operar no existe.	Compruebe si el ID del recurso que se va a consultar/operar es incorrecto.
409	Conflict	La instancia de modelo xxxxx ya existe, especifique un sufijo	Ya existe una instancia de despliegue con el nombre deployed_model xxxxx. Debe especificar un sufijo para distinguirla.	Especifique un sufijo único para el despliegue.
429	Throttling	Hay demasiados trabajos de ajuste fino en ejecución, inténtelo de nuevo más tarde. Solo se permiten 20 trabajos de ajuste fino en ejecución o completados con éxito por usuario.	La creación del recurso activó un límite de la plataforma.	Elimine los modelos que ya no estén en uso.
500	InternalError	¡Error interno del servidor!	Ocurrió un error interno.	Registre el request_id y contacte con los ingenieros de Alibaba Cloud enviando un ticket para solucionar el problema.

​Requisitos previos

​Consultar el estado del trabajo de ajuste fino

​Endpoint

​Ejemplo de solicitud

​Parámetros de solicitud

​Respuesta de ejemplo

​Parámetros de respuesta

​Cancelar un trabajo de ajuste fino

​Endpoint

​Ejemplo de solicitud

​Parámetros de solicitud

​Respuesta de ejemplo

​Parámetros de respuesta

​Eliminar un trabajo de ajuste fino

​Endpoint

​Ejemplo de solicitud

​Parámetros de solicitud

​Respuesta de ejemplo

​Parámetros de respuesta

​Consultar la lista de trabajos de ajuste fino

​Endpoint

​Ejemplo de solicitud

​Parámetros de solicitud

​Respuesta de ejemplo

​Parámetros de respuesta

​Consultar los registros del trabajo de ajuste fino

​Endpoint

​Ejemplo de solicitud

​Parámetros de solicitud

​Respuesta de ejemplo

​Parámetros de respuesta

​Respuestas de error

​Respuesta de ejemplo

​Parámetros de respuesta

Requisitos previos

Consultar el estado del trabajo de ajuste fino

Endpoint

Ejemplo de solicitud

Parámetros de solicitud

Respuesta de ejemplo

Parámetros de respuesta

Cancelar un trabajo de ajuste fino

Endpoint

Ejemplo de solicitud

Parámetros de solicitud

Respuesta de ejemplo

Parámetros de respuesta

Eliminar un trabajo de ajuste fino

Endpoint

Ejemplo de solicitud

Parámetros de solicitud

Respuesta de ejemplo

Parámetros de respuesta

Consultar la lista de trabajos de ajuste fino

Endpoint

Ejemplo de solicitud

Parámetros de solicitud

Respuesta de ejemplo

Parámetros de respuesta

Consultar los registros del trabajo de ajuste fino

Endpoint

Ejemplo de solicitud

Parámetros de solicitud

Respuesta de ejemplo

Parámetros de respuesta

Respuestas de error

Respuesta de ejemplo

Parámetros de respuesta