Model import

Authorization

Bearer ${DASHSCOPE_API_KEY}. Para mais informações sobre como obter uma chave de API, consulte Obter uma chave de API.

Content-Type

application/json

request_id

String

O ID da solicitação.

output.job_id

String

O ID da tarefa de importação, usado para consultar o status da tarefa ou excluí-la.

output.model_name

String

O identificador do modelo gerado pelo sistema, composto pelo nome do modelo base seguido por um sufixo de carimbo de data/hora.

output.display_name

String

O nome de exibição do modelo importado.

output.source

String

A origem da importação. O valor retornado é OSS em maiúsculas.

output.weight_type

String

O tipo de ajuste fino.

output.storage_info

Object

As informações de armazenamento da origem da importação, incluindo bucket_name e object_key.

output.status

String

O status da tarefa. Para mais informações, consulte Status da tarefa.

output.gmt_create

String

O horário de criação da tarefa no formato ISO 8601. Exemplo: 2024-01-01T12:00:00.000+00:00.

PENDING

A tarefa foi enviada e aguarda processamento.

RUNNING

A tarefa está em execução. O sistema valida e importa os arquivos do modelo.

SUCCESSED

A tarefa foi concluída com êxito. O modelo foi importado e pode ser implantado por meio da API Criar uma implantação.

FAILED

A execução da tarefa falhou. Consulte os detalhes da tarefa para obter o error_code correspondente ao motivo da falha.

model_name

String

body

Sim

Nome do modelo base. Corresponde ao campo Base Model no console. Para ver os modelos suportados, consulte Importação de modelos. Exemplo: qwen3-32b.

display_name

String

body

Não

Nome de exibição do modelo importado. Corresponde ao campo Model Name no console. Máximo de 50 caracteres. Se não especificado, o nome do modelo base será usado por padrão.

source

String

body

Sim

Origem da importação. Corresponde ao campo Import Source no console. Atualmente, apenas oss (importação do OSS) é suportado. A resposta retorna OSS em maiúsculas.

weight_type

String

body

Sim

Tipo de ajuste fino. full indica um modelo com ajuste fino de parâmetros completos. lora indica um modelo com ajuste fino LoRA.

storage_info

Object

body

Sim

Informações de armazenamento da origem da importação.

storage_info.bucket_name

String

body

Sim

Nome do bucket do OSS. Corresponde ao campo Bucket no console.

storage_info.object_key

String

body

Sim

Prefixo do caminho do OSS para os arquivos do modelo. Deve terminar com /. Exemplo: models/qwen3-32b-lora/.

request_id

String

O ID da solicitação.

output.job_id

String

O ID da tarefa de importação, utilizável nas APIs Consultar detalhes da tarefa de importação, Listar tarefas de importação e Excluir uma tarefa de importação.

output.model_name

String

O identificador do modelo gerado pelo sistema, composto pelo nome do modelo base seguido por um sufixo de carimbo de data/hora.

output.display_name

String

O nome de exibição do modelo importado.

output.source

String

A origem da importação. O valor retornado é OSS em maiúsculas.

output.weight_type

String

O tipo de ajuste fino.

output.storage_info

Object

As informações de armazenamento da origem da importação, incluindo bucket_name e object_key.

output.status

String

O status da tarefa. Para mais informações, consulte Status da tarefa.

output.gmt_create

String

O horário de criação da tarefa no formato ISO 8601. Exemplo: 2024-01-01T12:00:00.000+00:00.

job_id

String

path

Sim

O ID da tarefa de importação, obtido por meio da API Criar uma tarefa de importação ou Listar tarefas de importação.

page_no

Integer

query

Não

Número da página. Valor padrão: 1.

page_size

Integer

query

Não

Número de entradas por página. Valor padrão: 10. Valor máximo: 100.

status

String

query

Não

Filtro por status da tarefa. Para mais informações, consulte Status da tarefa.

model_name

String

query

Não

Filtro por nome do modelo. É necessário informar o nome gerado pelo sistema retornado na resposta (correspondência exata).

request_id

String

O ID da solicitação.

output.total

Integer

Total de tarefas correspondentes aos critérios de consulta.

output.page_no

Integer

Número da página atual.

output.page_size

Integer

Número de entradas por página.

output.list

Array

Lista de tarefas de importação. Cada elemento possui os mesmos campos dos parâmetros de resposta da API Criar uma tarefa de importação, exceto pela ausência do campo weight_type. O campo adicional error_code aparece quando a tarefa falha.

job_id

String

path

Sim

O ID da tarefa de importação, obtido por meio da API Criar uma tarefa de importação ou Listar tarefas de importação.

request_id

String

O ID da solicitação.

output

Object

Detalhes da tarefa excluída. Os campos são praticamente idênticos aos parâmetros de resposta da API Criar uma tarefa de importação, exceto pela ausência do campo weight_type.

InvalidParameter

Parâmetro de solicitação inválido. Por exemplo, um parâmetro obrigatório está ausente, o formato está incorreto ou o valor é inválido.

NotFound

O recurso especificado não existe. Por exemplo, o job_id não existe, o usuário não tem acesso ou o modelo base não suporta importação.

OperationDenied

Operação negada. Por exemplo, tentativa de excluir uma tarefa com status RUNNING.

InvalidApiKey

Chave de API inválida ou não fornecida.

InternalError

Erro interno do sistema. Tente novamente mais tarde.