Gestión de puntos de control

Requisitos previos

Región admitida: Las funciones descritas en este documento solo están disponibles en la región de Singapore. Debe utilizar una API Key de esta región.
Permisos de cuenta: Si utiliza una subcuenta del sitio de China (usuario RAM), necesita otorgar a la subcuenta los permisos de invocación de modelos, entrenamiento e implementación.
Configurar variables de entorno: Ha obtenido correctamente una API Key y la ha configurado como variable de entorno.
Tipos de modelos ajustados compatibles por API:
- Listar puntos de control: Generación de texto, Generación de video, Generación de imágenes, Síntesis de voz
- Exportar punto de control: Generación de texto, Generación de video, Generación de imágenes, Síntesis de voz
- Listar validaciones de puntos de control: Generación de video, Generación de imágenes
- Consultar resultados de validación de puntos de control: Generación de video, Generación de imágenes

Listar puntos de control

Lista todos los puntos de control y su estado, información del modelo, etc., para un trabajo de ajuste fino especificado.

Interfaz de solicitud

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

Parámetros de entrada

Parámetro	Ubicación	Tipo	Obligatorio	Descripción	Ejemplo
job_id	Ruta	string	Sí	ID del trabajo de ajuste fino. Puede obtenerlo desde la API Create fine-tune job o List fine-tune jobs.	ft-202511111122-xxxx

Parámetros de respuesta

Parámetro	Tipo	Descripción	Ejemplo
request_id	string	Identificador único de la solicitud.	aa4b0229-b1db-9afa-bb6e-xxxxxxxxx
output	array[object]	Matriz de checkpoints, ordenados por paso en orden descendente. Para modelos de síntesis de voz (como CosyVoice), el paso se deriva de la combinación de la época LM y la época FM. Los puntos de control se ordenan por el producto de época LM × época FM en orden descendente (un producto mayor indica un ajuste fino más exhaustivo en ambos lados).
output[].checkpoint_id	string	Identificador único del punto de control. Formato: `{job_id}:checkpoint-{step}`. El formato del paso varía según el tipo de modelo; consulte el campo `step` para más detalles.	ft-202605271743-dd2a:checkpoint-00040004
output[].full_name	string	Igual que `checkpoint_id`.	ft-202605271743-dd2a:checkpoint-00040004
output[].checkpoint	string	Nombre del checkpoint. Formato: `checkpoint-{step}`. Para modelos de síntesis de voz (como CosyVoice), el paso es una combinación de la época LM y la época FM. Por ejemplo, `checkpoint-00040004` significa época LM 4 + época FM 4.	checkpoint-00040004
output[].job_id	string	El ID del trabajo de ajuste fino al que pertenece este checkpoint.	ft-202605271743-dd2a
output[].step	integer	Número de paso de entrenamiento para este checkpoint. Para modelos de síntesis de voz (como CosyVoice), el paso se calcula como `LM_epoch × 10000 + FM_epoch`. Por ejemplo, 40004 significa época LM 4 + época FM 4.	40004
output[].status	string	Estado de este punto de control. Valores comunes: `SUCCEEDED` (listo para implementación), `PENDING` (aún no listo).	SUCCEEDED
output[].model_name	string	ID del modelo para este punto de control. Se puede usar como el parámetro `model_name` en la API Deploy Model. Solo se devuelve cuando`status=SUCCEEDED`.	cosyvoice-v3-flash-ft-202605271743-dd2a
output[].model_display_name	string	Nombre para mostrar del modelo (se muestra en la consola). Solo se devuelve cuando `status=SUCCEEDED`.	ft-202605271743-dd2a
output[].create_time	string	Hora de creación de este checkpoint en formato ISO 8601.	2026-05-27T18:07:16
output[].expire_time	string	Hora de caducidad de este checkpoint en formato ISO 8601.	2026-06-11T18:07:16

Ejemplo de solicitud

Reemplace <your-fine-tune-job-id> en la URL con el valor de job_id de la respuesta de Create fine-tune job.

Para Windows CMD, reemplace ${DASHSCOPE_API_KEY} con %DASHSCOPE_API_KEY%. Para PowerShell, use $env:DASHSCOPE_API_KEY

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/checkpoints' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json'

Ejemplo de respuesta

{
    "request_id": "aa4b0229-b1db-9afa-bb6e-3b3e9ee1489b",
    "output": [
        {
            "create_time": "2026-05-27T18:07:16",
            "full_name": "ft-202605271743-dd2a:checkpoint-00040004",
            "job_id": "ft-202605271743-dd2a",
            "checkpoint_id": "ft-202605271743-dd2a:checkpoint-00040004",
            "checkpoint": "checkpoint-00040004",
            "model_name": "cosyvoice-v3-flash-ft-202605271743-dd2a",
            "model_display_name": "ft-202605271743-dd2a",
            "status": "SUCCEEDED",
            "expire_time": "2026-06-11T18:07:16",
            "step": 40004
        },
        {
            "create_time": "2026-05-27T18:07:16",
            "full_name": "ft-202605271743-dd2a:checkpoint-00030004",
            "job_id": "ft-202605271743-dd2a",
            "checkpoint_id": "ft-202605271743-dd2a:checkpoint-00030004",
            "checkpoint": "checkpoint-00030004",
            "status": "PENDING",
            "expire_time": "2026-06-11T18:07:16",
            "step": 30004
        }
    ]
}

Exportar punto de control

Exporta un punto de control especificado como un modelo implementable. Después de una exportación exitosa, llame a la API de implementación correspondiente según el tipo de modelo (diferentes tipos de modelos utilizan diferentes APIs de implementación).

Interfaz de solicitud

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/export/{checkpoint}?model_name={model_name}

Parámetros de entrada

Parámetro

Ubicación

Tipo

Obligatorio

Descripción

Ejemplo

job_id

Ruta

string

Sí

ID del trabajo de ajuste fino. Puede obtenerlo desde la API Create fine-tune job o List fine-tune jobs.

ft-202511111122-xxxx

checkpoint

Ruta

string

Sí

Nombre del checkpoint. Puede obtenerlo de la API List Checkpoints.

checkpoint-160

model_name

Parámetro de consulta

string

Sí

El nombre del modelo exportado que se muestra en la consola.

Este nombre debe ser globalmente único. Se recomienda utilizar letras, dígitos, guiones bajos (_) y guiones (-).

Nota: Este parámetro es solo para visualización en la consola. El nombre real del modelo exportado es el valor de output[].model_name de la respuesta de List Checkpoints.

wan2.5-i2v-preview-ft-202511111122-xxxx

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

request_id

string

Identificador único de la solicitud.

0eb05b0c-02ba-414a-9d0c-xxxxxxxxx

output

boolean

Indica si la solicitud de exportación se envió correctamente.

true: La solicitud de exportación se envió correctamente.
false: La solicitud de exportación falló. Por favor, inténtelo de nuevo.

true

Ejemplo de solicitud

<your-fine-tune-job-id>: Reemplace con el valor de job_id de la respuesta de Create fine-tune job.
<checkpoint-to-export>: Reemplace con el valor del punto de control, por ejemplo, "checkpoint-160".
<export-model-display-name>: Reemplace con su nombre de modelo personalizado (solo para visualización en la consola).

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/export/<checkpoint-to-export>?model_name=<export-model-display-name>' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Ejemplo de respuesta

{
    "request_id": "0817d1ed-b6b6-4383-9650-xxxxx",
    "output": true
}

Listar validaciones de puntos de control

Esta API no es compatible con modelos de generación de texto.

Recupera la lista de puntos de control que generaron exitosamente videos de vista previa a través del conjunto de validación. Los puntos de control que fallan en la validación no se listan. Restricción de uso: Esta API debe llamarse después de que se complete el ajuste fino del modelo; de lo contrario, se devuelve una lista vacía.

Interfaz de solicitud

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

Parámetros de entrada

Parámetro	Ubicación	Tipo	Obligatorio	Descripción	Ejemplo
job_id	Ruta	string	Sí	ID del trabajo de ajuste fino. Puede obtenerlo desde la API Create fine-tune job o List fine-tune jobs.	ft-202511111122-xxxx

Parámetros de respuesta

Parámetro	Tipo	Descripción	Ejemplo
request_id	string	Identificador único de la solicitud.	0eb05b0c-02ba-414a-9d0c-xxxxxxxxx
output	array[string]	Lista de checkpoints.	-
output[].checkpoint	string	Nombre del checkpoint.	checkpoint-160

Ejemplo de solicitud

Reemplace <your-fine-tune-job-id> en la URL con el valor de job_id de la respuesta de Create fine-tune job.

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-results' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json'

Ejemplo de respuesta

{
    "request_id": "da1310f5-5a21-4e29-99d4-xxxxxx",
    "output": [
        {
            "checkpoint": "checkpoint-160"
        },
        {
            "checkpoint": "checkpoint-20"
        },
        {
            "checkpoint": "checkpoint-40"
        },
        {
            "checkpoint": "checkpoint-60"
        }
    ]
}

Consultar resultados de validación de puntos de control

Esta API no es compatible con modelos de generación de texto.

Consulta los detalles del resultado de validación para un punto de control especificado (por ejemplo, "checkpoint-160") mediante checkpoint, incluyendo los videos de vista previa generados.

Interfaz de solicitud

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/validation-details/{checkpoint}?page_no=1&page_size=10

Parámetros de entrada

Parámetro	Ubicación	Tipo	Obligatorio	Descripción	Ejemplo
job_id	Ruta	string	Sí	ID del trabajo de ajuste fino. Puede obtenerlo desde la API Create fine-tune job o List fine-tune jobs.	ft-202511111122-xxxx
checkpoint	Ruta	string	Sí	Nombre del punto de control. Puede obtenerlo desde la API List Checkpoints o List Checkpoint Validations.	checkpoint-160
page_no	Parámetro de consulta	integer	No	Número de página. El valor predeterminado es 1.	1
page_size	Parámetro de consulta	integer	No	Tamaño de página. El valor predeterminado es 10.	10

Parámetros de respuesta

Parámetro	Tipo	Descripción	Ejemplo
request_id	string	Identificador único de la solicitud.	375b3ad0-d3fa-451f-b629-xxxxxxx
output	object	Resultado de salida.	-
output.page_no	integer	Número de página.	1
output.page_size	integer	Tamaño de página.	10
output.total	integer	Número total de elementos de validación.	1
output.list	array[object]	Lista de elementos de validación.	-
output.list[].video_path	string	Video generado por el checkpoint. La URL de video_path es válida durante 24 horas. Por favor, descargue el video a la brevedad.	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx
output.list[].prompt	string	Prompt para los datos de validación. Obtenido del archivo de anotaciones del conjunto de datos data.jsonl.	El video comienza con una escena de un joven sentado en una cafetería...
output.list[].first_frame_path	string	URL de imagen para validación. El sistema lee la imagen del conjunto de datos y genera una URL pública.	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg

Ejemplo de solicitud

<your-fine-tune-job-id>: Reemplace con el valor de job_id de la respuesta de Create fine-tune job.
<selected-checkpoint>: Reemplace con el nombre del punto de control seleccionado, por ejemplo, "checkpoint-160".

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-details/<selected-checkpoint>?page_no=1&page_size=10' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Ejemplo de respuesta

La URL de video_path es válida durante 24 horas. Por favor, descargue el video a la brevedad.

{
    "request_id": "375b3ad0-d3fa-451f-b629-xxxxxxx",
    "output": {
        "page_no": 1,
        "page_size": 10,
        "total": 1,
        "list": [
            {
                "video_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx",
                "prompt": "The video begins with a young man sitting in a cafe. He wears a beige polo shirt with a focused, slightly contemplative expression, fingers lightly resting on his chin. In front of him is a steaming cup of coffee, with a wooden striped wall and a decorative sign in the background. Then the money rain effect begins, with countless oversized dollar bills pouring down like a storm, densely falling around him. As bills continue to fall, he stretches his arms upward, tilts his head back, and looks delighted, completely immersed in this wild money rain.",
                "first_frame_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg"
            }
        ]
    }
}

Objeto Checkpoint

La API Checkpoint actualmente solo está disponible en la región de Singapore. Si utiliza otras regiones, gestione los puntos de control a través de la consola de Model Studio de esa región.

El objeto Checkpoint representa un estado intermedio del modelo guardado durante el ajuste fino. Es devuelto por la API List Checkpoints.

Descripción de campos

Los siguientes campos provienen de la respuesta de la API List Checkpoints.

Parámetro	Tipo	Descripción
request_id	String	ID de solicitud para esta llamada.
output	Array	Matriz de checkpoints, ordenados por paso en orden descendente. Para modelos de síntesis de voz (como CosyVoice), el paso se deriva de la combinación de la época LM y la época FM. Los puntos de control se ordenan por el producto de época LM × época FM en orden descendente (un producto mayor indica un ajuste fino más exhaustivo en ambos lados).
output[*].checkpoint_id	String	Identificador único del punto de control. Formato: `{job_id}:checkpoint-{step}`. El formato del paso varía según el tipo de modelo; consulte el campo `step` para más detalles.
output[*].full_name	String	Igual que `checkpoint_id`.
output[*].checkpoint	String	Nombre del checkpoint. Formato: `checkpoint-{step}`. Para modelos de síntesis de voz (como CosyVoice), el paso es una combinación de la época LM y la época FM. Por ejemplo, `checkpoint-00040004` significa época LM 4 + época FM 4.
output[*].job_id	String	El ID del trabajo de ajuste fino al que pertenece este checkpoint.
output[*].step	Integer	Número de paso de entrenamiento para este checkpoint. Para modelos de síntesis de voz (como CosyVoice), el paso se calcula como `LM_epoch × 10000 + FM_epoch`. Por ejemplo, 40004 significa época LM 4 + época FM 4.
output[*].status	String	Estado de este punto de control. Valores comunes: `SUCCEEDED` (listo para implementación), `PENDING` (aún no listo).
output[*].model_name	String	ID del modelo para este punto de control. Se puede usar como el parámetro `model_name` en la API Deploy Model. Solo se devuelve cuando`status=SUCCEEDED`.
output[*].model_display_name	String	Nombre para mostrar del modelo (se muestra en la consola). Solo se devuelve cuando `status=SUCCEEDED`.
output[*].create_time	String	Hora de creación de este checkpoint en formato ISO 8601.
output[*].expire_time	String	Hora de caducidad de este checkpoint en formato ISO 8601.

​Requisitos previos

​Listar puntos de control

​Interfaz de solicitud

​Parámetros de entrada

​Parámetros de respuesta

​Ejemplo de solicitud

​Ejemplo de respuesta

​Exportar punto de control

​Interfaz de solicitud

​Parámetros de entrada

​Parámetros de respuesta

​Ejemplo de solicitud

​Ejemplo de respuesta

​Listar validaciones de puntos de control

​Interfaz de solicitud

​Parámetros de entrada

​Parámetros de respuesta

​Ejemplo de solicitud

​Ejemplo de respuesta

​Consultar resultados de validación de puntos de control

​Interfaz de solicitud

​Parámetros de entrada

​Parámetros de respuesta

​Ejemplo de solicitud

​Ejemplo de respuesta

​Objeto Checkpoint

​Descripción de campos

Requisitos previos

Listar puntos de control

Interfaz de solicitud

Parámetros de entrada

Parámetros de respuesta

Ejemplo de solicitud

Ejemplo de respuesta

Exportar punto de control

Interfaz de solicitud

Parámetros de entrada

Parámetros de respuesta

Ejemplo de solicitud

Ejemplo de respuesta

Listar validaciones de puntos de control

Interfaz de solicitud

Parámetros de entrada

Parámetros de respuesta

Ejemplo de solicitud

Ejemplo de respuesta

Consultar resultados de validación de puntos de control

Interfaz de solicitud

Parámetros de entrada

Parámetros de respuesta

Ejemplo de solicitud

Ejemplo de respuesta

Objeto Checkpoint

Descripción de campos