Skip to main content
Model tuning

Obter detalhes do trabalho de ajuste fino

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

Obter detalhes do trabalho de ajuste fino

No Windows CMD, substitua ${DASHSCOPE_API_KEY} por %DASHSCOPE_API_KEY% . No PowerShell, use $env:DASHSCOPE_API_KEY .
curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your_fine_tuning_job_id>" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

Parâmetros da requisição

Parâmetro

Tipo

Localização

Obrigatório

Descrição

job_id

String

Path

Sim

ID do trabalho de ajuste fino a recuperar. Corresponde ao job_id retornado nos Parâmetros de resposta da criação de trabalho de ajuste fino.

Exemplos 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": [
                  "976bd01a-f30b-4414-86fd-50c54486e3ef"
              ],
              "validation_file_ids": [],
              "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

Parâmetro

Tipo

Descrição

request_id

String

ID exclusivo desta requisição.

output

Object

Detalhes do trabalho de ajuste fino.

output.job_id

String

Identificador do trabalho de ajuste fino, usado para consultar seu status.

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

output.job_name

String

Mesmo valor de output.job_id.

output.status

String

Status da tarefa deste trabalho de ajuste fino.

output.finetuned_output

String

Campo retornado apenas quando o status da tarefa é SUCCEEDED.

output.model

String

ID do modelo usado no trabalho de ajuste fino.

output.base_model

String

ID do modelo base usado neste trabalho de ajuste fino.

Por exemplo, o trabalho ft-202410291653-1c7f usa o modelo base qwen3-14b.

output.training_file_ids

Array

Lista de IDs dos arquivos de treinamento.

output.validation_file_ids

Array

Lista de IDs dos arquivos de validação.

output.hyper_parameters

Object

Mapa com os hiperparâmetros especificados explicitamente.

output.training_type

String

Método de ajuste fino aplicado.

output.create_time

String

Data e hora de criação do trabalho de ajuste fino.

output.workspace_id

String

ID do workspace que contém o trabalho de ajuste fino.

output.user_identity

String

UID da conta principal proprietária deste trabalho de ajuste fino.

output.modifier

String

UID da conta que modificou este trabalho pela última vez. Se uma subconta cancelar o trabalho, por exemplo, o UID dessa subconta aparecerá aqui.

output.creator

String

UID da conta que criou este trabalho de ajuste fino.

output.end_time

String

Horário de término do trabalho de ajuste fino. Este campo é retornado quando o status da tarefa é SUCCEEDED, FAILED ou CANCELED.

output.group

String

Tipo do trabalho de ajuste fino.

output.usage

Integer

Quantidade de tokens consumidos pelo trabalho de ajuste fino. Para a fórmula de cobrança, consulte os itens faturáveis. Retornado quando o status da tarefa é SUCCEEDED ou CANCELED.

output.output_cnt

Integer

Quantidade de checkpoints gerados até o momento. Retornado apenas para modelos que suportam múltiplas saídas de checkpoint (por exemplo, cosyvoice-v3-flash). Para obter a lista completa de checkpoints, chame a API Listar checkpoints.

output.max_output_cnt

Integer

Número máximo de checkpoints que uma única tarefa pode produzir. Qualquer valor de output_cnt acima desse limite é truncado com base na suficiência do ajuste. Retornado apenas para modelos compatíveis com múltiplas saídas de checkpoint.

Códigos de erro

Retornados quando a requisição falha.

Campo

Tipo

Descrição

Valor de exemplo

code

String

Código do erro.

NotFound

request_id

String

ID exclusivo da requisição gerado pelo sistema.

6332fb02-3111-43f0-bf79-f9e8c5ffa7f9

message

String

Mensagem de erro.

Not Found!

Exemplo de resposta de erro
{
        "code": "NotFound",
        "request_id": "BE213CDD-8A5C-59EE-9A67-055EAB0CB59B",
        "message": "Not Found!"
      }
Lista de códigos de erro

Código de status HTTP

Código de erro

Mensagem de exemplo

Descrição

Solução

400

InvalidParameter

Missing training files

Parâmetro inválido, ausente ou com formato incorreto.

Verifique a mensagem de erro e corrija os parâmetros na requisição.

400

UnsupportedOperation

Não é possível excluir o trabalho de ajuste fino porque seu status é SUCCEEDED, FAILED ou CANCELED.

Operação não permitida porque o recurso está em um estado específico.

Aguarde até que o recurso atinja um estado válido antes de tentar novamente.

404

NotFound

Not found!

O recurso solicitado não existe.

Verifique se o ID do recurso acessado está correto.

409

Conflict

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

Já existe uma instância de implantação com o nome 'xxxxx'. Especifique um sufixo para tornar o nome exclusivo.

Defina um sufixo exclusivo para a implantação.

429

Throttling

  • Há muitos trabalhos de ajuste fino em execução no momento. Tente novamente mais tarde.

  • Um usuário pode ter no máximo 20 trabalhos de ajuste fino nos estados 'running' ou 'succeeded'.

Requisição negada devido aos limites da plataforma.

  • Exclua modelos não utilizados.

500

InternalError

Internal server error!

Ocorreu um erro interno no servidor.

Anote o request_id e abra um ticket para obter assistência.

Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
API em tempo real
Incorporação de Texto
Produção de Modelos