Skip to main content

Obter detalhes do trabalho de ajuste fino

Recupera os detalhes de um trabalho de ajuste fino específico.

Pré-requisitos

Consultar o status do trabalho de ajuste fino

Consulta as informações detalhadas e o status de execução de um trabalho de ajuste fino especificado.

Endpoint

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

Exemplo de requisição

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 da requisição

Campo

Tipo

Passagem de parâmetros

Obrigatório

Descrição

job_id

String

Url Path

Sim

O ID do trabalho de ajuste fino a ser consultado. Ele é o job_id nos parâmetros de resposta para criar um trabalho de ajuste fino.

Exemplo de resposta

  • Modelo de geração de texto
  • Modelo de geração de vídeo
  • Modelo de geração de imagem
{
    "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
    }
}

Parâmetros de resposta

Nome do parâmetro

Tipo

Descrição

request_id

String

O ID da requisição.

output

Object

Os detalhes do trabalho de ajuste fino.

output.job_id

String

O ID do trabalho de ajuste fino. Você pode usar esse ID para consultar o status do trabalho posteriormente.

Regra de geração: ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

O mesmo que output.job_id.

output.status

String

O status do trabalho deste trabalho de ajuste fino.

output.finetuned_output

String

Este parâmetro aparece somente quando o status do trabalho de ajuste fino é SUCCEED. Ele retorna o ID do modelo ajustado.

output.model

String

O ID do modelo usado no trabalho de ajuste fino.

output.base_model

String

O ID do modelo de base que corresponde ao modelo usado no trabalho de ajuste fino.

Por exemplo, o modelo de base usado pelo trabalho de ajuste fino ft-202410291653-1c7f é qwen3-14b.

output.training_file_ids

Array

Um campo para compatibilidade. Novos trabalhos sempre retornam um array vazio. Use training_datasets em vez disso.

output.validation_file_ids

Array

Um campo para compatibilidade. Novos trabalhos sempre retornam um array vazio. Use validation_datasets em vez disso.

output.training_datasets

Array of Dataset

Uma lista de conjuntos de dados de treinamento.

output.validation_datasets

Array of Dataset

Uma lista de conjuntos de dados de teste.

output.hyper_parameters

Object

Os hiperparâmetros declarados explicitamente.

output.training_type

String

O método de ajuste fino.

output.create_time

String

A data e a hora em que o trabalho de ajuste fino foi criado.

output.workspace_id

String

O ID do workspace ao qual o trabalho de ajuste fino pertence.

output.user_identity

String

O UID da conta principal à qual o trabalho de ajuste fino pertence.

output.modifier

String

O UID da conta que realizou a última operação no trabalho de ajuste fino. (Por exemplo, se um usuário RAM cancelar o trabalho, o UID desse usuário RAM será exibido aqui.)

output.creator

String

O UID do usuário que criou o trabalho de ajuste fino.

output.end_time

String

A data e a hora em que o trabalho de ajuste fino terminou. Este parâmetro aparece quando o status do trabalho é SUCCEED, FAILED ou CANCELED.

output.group

String

O tipo de tarefa do ajuste fino do modelo.

output.usage

Integer

O número de tokens (contagem) consumidos pelo trabalho de ajuste fino. Para a fórmula de cobrança, consulte Cobrança. Este parâmetro aparece quando o status do trabalho é SUCCEED ou CANCELED.

output.output_cnt

Integer

O número de Checkpoints que o trabalho atual gerou. Este parâmetro é retornado somente para modelos que suportam múltiplas saídas de Checkpoint (como cosyvoice-v3-flash). Você pode obter a lista detalhada de Checkpoints chamando a operação de consultar Checkpoint.

output.max_output_cnt

Integer

O número máximo de Checkpoints que um único trabalho pode gerar. A parte de output_cnt que excede esse limite é truncada com base na suficiência do ajuste fino. Este parâmetro é retornado somente para modelos que suportam múltiplas saídas de Checkpoint.

Cancelar um trabalho de ajuste fino

Cancela um trabalho de ajuste fino em execução. Somente trabalhos no estado de execução podem ser cancelados.

Endpoint

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

Exemplo de requisição

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 da requisição

Campo

Tipo

Passagem de parâmetros

Obrigatório

Descrição

job_id

String

Url Path

Sim

O ID do trabalho de ajuste fino a ser cancelado. Você pode obter esse ID chamando a operação criar trabalho de treinamento ou listar trabalhos de treinamento.

Exemplo de resposta

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

Parâmetros de resposta

Nome do parâmetro

Tipo

Descrição

request_id

String

O ID da requisição.

output

Object

Os detalhes retornados para a operação de cancelamento.

Excluir um trabalho de ajuste fino

Exclui o registro de um trabalho de ajuste fino especificado.

Endpoint

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

Exemplo de requisição

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 da requisição

Campo

Tipo

Passagem de parâmetros

Obrigatório

Descrição

job_id

String

Url Path

Sim

O ID do trabalho de ajuste fino a ser excluído. Você pode obter esse ID chamando a operação criar trabalho de treinamento ou listar trabalhos de treinamento.

Exemplo de resposta

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

Parâmetros de resposta

Nome do parâmetro

Tipo

Descrição

request_id

String

O ID da requisição.

output

Object

Os detalhes retornados para a operação de exclusão.

Consultar a lista de trabalhos de ajuste fino

Consulta a lista de trabalhos de ajuste fino da conta atual de forma paginada.

Endpoint

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

Exemplo de requisição

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 da requisição

Nome do parâmetro

Tipo

Passagem de parâmetros

Obrigatório

Descrição

page_no

Integer

Query

Não

Valor padrão: 1.

page_size

Integer

Query

Não

Valor padrão: 10. Máximo: 1000. Mínimo: 1.

model

String

Query

Não

O ID do modelo. Se você especificar este parâmetro, somente os trabalhos de ajuste fino baseados neste modelo serão listados.

Exemplo de resposta

{
    "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 resposta

Nome do parâmetroTipoDescrição
request_idStringO ID da requisição.
outputObjectOs detalhes retornados para a consulta.
output.page_noIntegerO número da página.
output.page_sizeIntegerO número de entradas exibidas por página.
output.totalIntegerO número total de trabalhos de ajuste fino.
output.jobsArrayOs detalhes de vários trabalhos de ajuste fino.

Nome do parâmetro

Tipo

Descrição

request_id

String

O ID da requisição.

output

Object

Os detalhes do trabalho de ajuste fino.

output.job_id

String

O ID do trabalho de ajuste fino. Você pode usar esse ID para consultar o status do trabalho posteriormente.

Regra de geração: ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

O mesmo que output.job_id.

output.status

String

O status do trabalho deste trabalho de ajuste fino.

output.finetuned_output

String

Este parâmetro aparece somente quando o status do trabalho de ajuste fino é SUCCEED. Ele retorna o ID do modelo ajustado.

output.model

String

O ID do modelo usado no trabalho de ajuste fino.

output.base_model

String

O ID do modelo de base que corresponde ao modelo usado no trabalho de ajuste fino.

Por exemplo, o modelo de base usado pelo trabalho de ajuste fino ft-202410291653-1c7f é qwen3-14b.

output.training_file_ids

Array

Um campo para compatibilidade. Novos trabalhos sempre retornam um array vazio. Use training_datasets em vez disso.

output.validation_file_ids

Array

Um campo para compatibilidade. Novos trabalhos sempre retornam um array vazio. Use validation_datasets em vez disso.

output.training_datasets

Array of Dataset

Uma lista de conjuntos de dados de treinamento.

output.validation_datasets

Array of Dataset

Uma lista de conjuntos de dados de teste.

output.hyper_parameters

Object

Os hiperparâmetros declarados explicitamente.

output.training_type

String

O método de ajuste fino.

output.create_time

String

A data e a hora em que o trabalho de ajuste fino foi criado.

output.workspace_id

String

O ID do workspace ao qual o trabalho de ajuste fino pertence.

output.user_identity

String

O UID da conta principal à qual o trabalho de ajuste fino pertence.

output.modifier

String

O UID da conta que realizou a última operação no trabalho de ajuste fino. (Por exemplo, se um usuário RAM cancelar o trabalho, o UID desse usuário RAM será exibido aqui.)

output.creator

String

O UID do usuário que criou o trabalho de ajuste fino.

output.end_time

String

A data e a hora em que o trabalho de ajuste fino terminou. Este parâmetro aparece quando o status do trabalho é SUCCEED, FAILED ou CANCELED.

output.group

String

O tipo de tarefa do ajuste fino do modelo.

output.usage

Integer

O número de tokens (contagem) consumidos pelo trabalho de ajuste fino. Para a fórmula de cobrança, consulte Cobrança. Este parâmetro aparece quando o status do trabalho é SUCCEED ou CANCELED.

output.output_cnt

Integer

O número de Checkpoints que o trabalho atual gerou. Este parâmetro é retornado somente para modelos que suportam múltiplas saídas de Checkpoint (como cosyvoice-v3-flash). Você pode obter a lista detalhada de Checkpoints chamando a operação de consultar Checkpoint.

output.max_output_cnt

Integer

O número máximo de Checkpoints que um único trabalho pode gerar. A parte de output_cnt que excede esse limite é truncada com base na suficiência do ajuste fino. Este parâmetro é retornado somente para modelos que suportam múltiplas saídas de Checkpoint.

Consultar logs de trabalhos de ajuste fino

Consulta os logs de treinamento de um trabalho de ajuste fino especificado.

Endpoint

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

Exemplo de requisição

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 da requisição

Campo

Tipo

Passagem de parâmetros

Obrigatório

Descrição

job_id

String

Url Path

Sim

O ID do trabalho de ajuste fino para o qual exibir os logs. Você pode obter esse ID chamando a operação de criar trabalho de treinamento ou de listar trabalhos de treinamento.

offset

Number

Query

Não

Ignora as primeiras offset linhas da saída e começa a ler a partir da linha offset+1. O valor não pode exceder o número total de linhas da saída existente; caso contrário, nenhuma informação de saída é retornada. O valor padrão é 0.

line

Number

Query

Não

Lê line linhas de saída começando (inclusive) a partir da linha offset+1. Se a saída desta requisição tiver menos de line linhas, a saída real é retornada. O valor padrão é 100 e o limite superior é 1000.

Exemplo de resposta

{
    "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 resposta

Nome do parâmetro

Tipo

Descrição

request_id

String

O ID da requisição.

output

Object

Os detalhes retornados para a consulta.

output.total

Integer

O número total de linhas de log.

output.logs

Array

Os logs de saída.

Respostas de erro

Exemplo de resposta

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

Parâmetros de resposta

Campo

Tipo

Descrição

Valor de exemplo

code

String

O código de erro.

NotFound

request_id

String

O código exclusivo do sistema da requisição.

6332fb02-3111-43f0-bf79-f9e8c5ffa7f9

message

String

A mensagem de erro.

Not Found!

Quando uma requisição falha, os seguintes erros podem ser retornados:

Código de status HTTP

Código de erro

Mensagem de erro de exemplo

Significado

Solução

400

InvalidParameter

Missing training files

Um parâmetro é inválido. Por exemplo, um parâmetro está ausente ou tem um formato incorreto.

Corrija seus parâmetros com base na mensagem de erro.

400

UnsupportedOperation

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

A operação não pode ser executada no recurso em seu estado atual.

Execute a operação depois que o recurso entrar em um estado operável.

400

UnsupportedOperation

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

A operação não pode ser executada no recurso em seu estado atual.

Execute a operação depois que o recurso entrar em um estado operável.

404

NotFound

Not found!

O recurso a consultar/operar não existe.

Verifique se o ID do recurso a consultar/operar está incorreto.

409

Conflict

Model instance xxxxx already exists, please specify a suffix

Já existe uma instância de implantação com o nome deployed_model xxxxx. Você deve especificar um sufixo para distingui-la.

Especifique um sufixo exclusivo para a implantação.

429

Throttling

  • Too many fine-tune job in running, please retry later.

  • Only 20 fine-tune job in running or succeeded allowed per user.

A criação do recurso acionou um limite da plataforma.

  • Exclua modelos que não estão mais em uso.

500

InternalError

Internal server error!

Ocorreu um erro interno.

Registre o request_id e entre em contato com os engenheiros da Alibaba Cloud enviando um ticket para solução de problemas.