Skip to main content

Query fine-tuning task details

Obtenez les détails d'une tâche spécifique de fine-tuning de modèle.

Prérequis

Consulter le statut d'une tâche de fine-tuning

Interrogez les informations détaillées et le statut d'exécution d'une tâche de fine-tuning spécifiée.

Point de terminaison

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

Exemple de requête

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'

Paramètres de la requête

Champ

Type

Mode de transmission

Obligatoire

Description

job_id

String

Url Path

Oui

ID de la tâche de fine-tuning à consulter. Il s'agit du job_id figurant dans les paramètres de réponse de la création d'une tâche de fine-tuning.

Exemple de réponse

  • Modèle de génération de texte
  • Modèle de génération vidéo
  • Modèle de génération d'images
{
    "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
    }
}

Paramètres de la réponse

Nom du paramètre

Type

Description

request_id

String

ID de la requête.

output

Object

Détails de la tâche de fine-tuning.

output.job_id

String

ID de la tâche de fine-tuning. Vous pouvez utiliser cet ID pour interroger ultérieurement le statut de la tâche.

Règle de génération : ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

Identique à output.job_id.

output.status

String

Statut de cette tâche de fine-tuning.

output.finetuned_output

String

Ce paramètre n'apparaît que lorsque le statut de la tâche de fine-tuning est SUCCEED. Il retourne l'ID du modèle fine-tuné.

output.model

String

ID du modèle utilisé pour la tâche de fine-tuning.

output.base_model

String

ID du modèle de base correspondant au modèle utilisé pour la tâche de fine-tuning.

Par exemple, le modèle de base utilisé par la tâche de fine-tuning ft-202410291653-1c7f est qwen3-14b.

output.training_file_ids

Array

Champ conservé pour compatibilité. Les nouvelles tâches retournent toujours un tableau vide. Utilisez plutôt training_datasets.

output.validation_file_ids

Array

Champ conservé pour compatibilité. Les nouvelles tâches retournent toujours un tableau vide. Utilisez plutôt validation_datasets.

output.training_datasets

Array of Dataset

Liste des jeux de données d'entraînement.

output.validation_datasets

Array of Dataset

Liste des jeux de données de test.

output.hyper_parameters

Object

Les hyperparamètres explicitement déclarés.

output.training_type

String

La méthode de fine-tuning.

output.create_time

String

Heure de création de la tâche de fine-tuning.

output.workspace_id

String

ID de l'espace de travail auquel appartient la tâche de fine-tuning.

output.user_identity

String

UID du compte principal auquel appartient la tâche de fine-tuning.

output.modifier

String

UID du compte ayant effectué la dernière opération sur la tâche de fine-tuning. (Par exemple, si un utilisateur RAM annule la tâche, l'UID de cet utilisateur RAM s'affiche ici.)

output.creator

String

UID de l'utilisateur ayant créé la tâche de fine-tuning.

output.end_time

String

Heure de fin de la tâche de fine-tuning. Ce paramètre apparaît lorsque le statut de la tâche est SUCCEED, FAILED ou CANCELED.

output.group

String

Type de tâche du fine-tuning du modèle.

output.usage

Integer

Nombre de tokens (nombre) consommés par la tâche de fine-tuning. Pour la formule de facturation, consultez Facturation. Ce paramètre apparaît lorsque le statut de la tâche est SUCCEED ou CANCELED.

output.output_cnt

Integer

Nombre de checkpoints générés par la tâche actuelle. Ce paramètre n'est retourné que pour les modèles prenant en charge la sortie de plusieurs checkpoints (tels que cosyvoice-v3-flash). Vous pouvez obtenir la liste détaillée des checkpoints en appelant l'opération Query Checkpoint.

output.max_output_cnt

Integer

Nombre maximal de checkpoints qu'une seule tâche peut générer. La partie de output_cnt qui dépasse cette limite est tronquée en fonction de la suffisance du fine-tuning. Ce paramètre n'est retourné que pour les modèles prenant en charge la sortie de plusieurs checkpoints.

Annuler une tâche de fine-tuning

Annule une tâche de fine-tuning en cours d'exécution. Seules les tâches en cours d'exécution peuvent être annulées.

Point de terminaison

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

Exemple de requête

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'

Paramètres de la requête

Champ

Type

Mode de transmission

Obligatoire

Description

job_id

String

Url Path

Oui

ID de la tâche de fine-tuning à annuler. Vous pouvez obtenir cet ID en appelant l'opération créer une tâche d'entraînement ou répertorier les tâches d'entraînement.

Exemple de réponse

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

Paramètres de la réponse

Nom du paramètre

Type

Description

request_id

String

ID de la requête.

output

Object

Détails retournés pour l'opération d'annulation.

Supprimer une tâche de fine-tuning

Supprime l'enregistrement d'une tâche de fine-tuning spécifiée.

Point de terminaison

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

Exemple de requête

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'

Paramètres de la requête

Champ

Type

Mode de transmission

Obligatoire

Description

job_id

String

Url Path

Oui

ID de la tâche de fine-tuning à supprimer. Vous pouvez obtenir cet ID en appelant l'opération créer une tâche d'entraînement ou répertorier les tâches d'entraînement.

Exemple de réponse

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

Paramètres de la réponse

Nom du paramètre

Type

Description

request_id

String

ID de la requête.

output

Object

Détails retournés pour l'opération de suppression.

Consulter la liste des tâches de fine-tuning

Interroge la liste des tâches de fine-tuning du compte actuel de manière paginée.

Point de terminaison

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

Exemple de requête

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'

Paramètres de la requête

Nom du paramètre

Type

Mode de transmission

Obligatoire

Description

page_no

Integer

Query

Non

Valeur par défaut : 1.

page_size

Integer

Query

Non

Valeur par défaut : 10. Maximum : 1000. Minimum : 1.

model

String

Query

Non

ID du modèle. Si vous spécifiez ce paramètre, seules les tâches de fine-tuning basées sur ce modèle sont répertoriées.

Exemple de réponse

{
    "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
            }
        ]
    }
}

Paramètres de la réponse

Nom du paramètreTypeDescription
request_idStringID de la requête.
outputObjectDétails retournés pour la requête.
output.page_noIntegerNuméro de page.
output.page_sizeIntegerNombre d'entrées affichées par page.
output.totalIntegerNombre total de tâches de fine-tuning.
output.jobsArrayDétails de plusieurs tâches de fine-tuning.

Nom du paramètre

Type

Description

request_id

String

ID de la requête.

output

Object

Détails de la tâche de fine-tuning.

output.job_id

String

ID de la tâche de fine-tuning. Vous pouvez utiliser cet ID pour interroger ultérieurement le statut de la tâche.

Règle de génération : ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

Identique à output.job_id.

output.status

String

Statut de cette tâche de fine-tuning.

output.finetuned_output

String

Ce paramètre n'apparaît que lorsque le statut de la tâche de fine-tuning est SUCCEED. Il retourne l'ID du modèle fine-tuné.

output.model

String

ID du modèle utilisé pour la tâche de fine-tuning.

output.base_model

String

ID du modèle de base correspondant au modèle utilisé pour la tâche de fine-tuning.

Par exemple, le modèle de base utilisé par la tâche de fine-tuning ft-202410291653-1c7f est qwen3-14b.

output.training_file_ids

Array

Champ conservé pour compatibilité. Les nouvelles tâches retournent toujours un tableau vide. Utilisez plutôt training_datasets.

output.validation_file_ids

Array

Champ conservé pour compatibilité. Les nouvelles tâches retournent toujours un tableau vide. Utilisez plutôt validation_datasets.

output.training_datasets

Array of Dataset

Liste des jeux de données d'entraînement.

output.validation_datasets

Array of Dataset

Liste des jeux de données de test.

output.hyper_parameters

Object

Les hyperparamètres explicitement déclarés.

output.training_type

String

La méthode de fine-tuning.

output.create_time

String

Heure de création de la tâche de fine-tuning.

output.workspace_id

String

ID de l'espace de travail auquel appartient la tâche de fine-tuning.

output.user_identity

String

UID du compte principal auquel appartient la tâche de fine-tuning.

output.modifier

String

UID du compte ayant effectué la dernière opération sur la tâche de fine-tuning. (Par exemple, si un utilisateur RAM annule la tâche, l'UID de cet utilisateur RAM s'affiche ici.)

output.creator

String

UID de l'utilisateur ayant créé la tâche de fine-tuning.

output.end_time

String

Heure de fin de la tâche de fine-tuning. Ce paramètre apparaît lorsque le statut de la tâche est SUCCEED, FAILED ou CANCELED.

output.group

String

Type de tâche du fine-tuning du modèle.

output.usage

Integer

Nombre de tokens (nombre) consommés par la tâche de fine-tuning. Pour la formule de facturation, consultez Facturation. Ce paramètre apparaît lorsque le statut de la tâche est SUCCEED ou CANCELED.

output.output_cnt

Integer

Nombre de checkpoints générés par la tâche actuelle. Ce paramètre n'est retourné que pour les modèles prenant en charge la sortie de plusieurs checkpoints (tels que cosyvoice-v3-flash). Vous pouvez obtenir la liste détaillée des checkpoints en appelant l'opération Query Checkpoint.

output.max_output_cnt

Integer

Nombre maximal de checkpoints qu'une seule tâche peut générer. La partie de output_cnt qui dépasse cette limite est tronquée en fonction de la suffisance du fine-tuning. Ce paramètre n'est retourné que pour les modèles prenant en charge la sortie de plusieurs checkpoints.

Consulter les journaux d'une tâche de fine-tuning

Interroge les journaux d'entraînement d'une tâche de fine-tuning spécifiée.

Point de terminaison

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

Exemple de requête

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'

Paramètres de la requête

Champ

Type

Mode de transmission

Obligatoire

Description

job_id

String

Url Path

Oui

ID de la tâche de fine-tuning pour laquelle afficher les journaux. Vous pouvez obtenir cet ID en appelant l'opération créer une tâche d'entraînement ou répertorier les tâches d'entraînement.

offset

Number

Query

Non

Ignore les premières offset lignes de sortie et commence la lecture à partir de la ligne offset+1. La valeur ne peut pas dépasser le nombre total de lignes de sortie existantes ; sinon, aucune information de sortie n'est retournée. La valeur par défaut est 0.

line

Number

Query

Non

Lit line lignes de sortie à partir de (et y compris) la ligne offset+1. Si la sortie de cette requête contient moins de line lignes, la sortie réelle est retournée. La valeur par défaut est 100 et la limite supérieure est 1000.

Exemple de réponse

{
    "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##"
        ]
    }
}

Paramètres de la réponse

Nom du paramètre

Type

Description

request_id

String

ID de la requête.

output

Object

Détails retournés pour la requête.

output.total

Integer

Nombre total de lignes de journal.

output.logs

Array

Les journaux de sortie.

Réponses d'erreur

Exemple de réponse

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

Paramètres de la réponse

Champ

Type

Description

Exemple de valeur

code

String

Code d'erreur.

NotFound

request_id

String

Code système unique de la requête.

6332fb02-3111-43f0-bf79-f9e8c5ffa7f9

message

String

Message d'erreur.

Not Found!

Lorsqu'une requête échoue, les erreurs suivantes peuvent être retournées :

Code de statut HTTP

Code d'erreur

Exemple de message d'erreur

Signification

Solution

400

InvalidParameter

Fichiers d'entraînement manquants

Un paramètre est invalide. Par exemple, un paramètre est manquant ou son format est incorrect.

Corrigez vos paramètres en fonction du message d'erreur.

400

UnsupportedOperation

La tâche de fine-tuning ne peut pas être annulée car elle a réussi ou échoué

L'opération ne peut pas être effectuée sur la ressource dans son état actuel.

Effectuez l'opération après que la ressource soit entrée dans un état opérationnel.

400

UnsupportedOperation

La tâche de fine-tuning ne peut pas être supprimée car elle a réussi, échoué ou été annulée

L'opération ne peut pas être effectuée sur la ressource dans son état actuel.

Effectuez l'opération après que la ressource soit entrée dans un état opérationnel.

404

NotFound

Not found!

La ressource à interroger/exploiter n'existe pas.

Vérifiez si l'ID de la ressource à interroger/exploiter est incorrect.

409

Conflict

L'instance de modèle xxxxx existe déjà, veuillez spécifier un suffixe

Une instance de déploiement portant le nom deployed_model xxxxx existe déjà. Vous devez spécifier un suffixe pour la distinguer.

Spécifiez un suffixe unique pour le déploiement.

429

Throttling

  • Trop de tâches de fine-tuning en cours d'exécution, veuillez réessayer plus tard.

  • Seules 20 tâches de fine-tuning en cours d'exécution ou réussies sont autorisées par utilisateur.

La création de la ressource a déclenché une limite de la plateforme.

  • Supprimez les modèles qui ne sont plus utilisés.

500

InternalError

Internal server error!

Une erreur interne s'est produite.

Notez le request_id et contactez les ingénieurs Alibaba Cloud en soumettant un ticket pour le dépannage.