Alibaba Cloud Model Studio:API de gerenciamento de tarefas assíncronas

Header

Authorization

String

Sim

Chave de API no formato Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

Sim

id da tarefa a consultar.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

request_id

String

id exclusivo desta requisição.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

output

Object

• Se a tarefa for bem-sucedida, output contém o objeto de resultado gerado pelo modelo. O conteúdo varia conforme o tipo de tarefa.

• Em caso de falha total ou parcial da tarefa, output retorna os campos code e message, que explicam o motivo da falha.

• Para tarefas com múltiplas subtarefas, output pode conter tanto os resultados das subtarefas bem-sucedidas quanto as mensagens de erro das que falharam.

-

output.task_id

String

id da tarefa consultada.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

output.task_status

String

Status da tarefa.

• Em tarefas com múltiplas subtarefas, a tarefa principal é considerada bem-sucedida se pelo menos uma subtarefa for concluída com êxito.

• Subtarefas com falha apresentam erros específicos na saída.

Status da tarefa:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• UNKNOWN

output.submit_time

String

Horário de envio da tarefa.

2023-12-20 21:36:31.896

output.scheduled_time

String

Horário em que a tarefa foi agendada (momento de início da execução).

2023-12-20 21:36:39.009

output.end_time

String

Horário de término da tarefa.

2023-12-20 21:36:45.913

output.code

String

Código de erro (retornado apenas quando a tarefa falha).

-

output.message

String

Mensagem de erro (retornada apenas quando a tarefa falha).

-

output.task_metrics

Object

Métricas da tarefa, incluindo estatísticas de status das subtarefas.

{

"TOTAL": 4, // Total number of subtasks

"SUCCEEDED": 3, // Number of successful subtasks

"FAILED": 1 // Number of failed subtasks

}

usage

Object

Informações de faturamento desta requisição (varia conforme a tarefa).

"usage": {"image_count": 1}

Header

Authorization

String

Sim

Chave de API no formato Bearer sk-xxx.

Bearer sk-xxx

Params

task_id

String

Não

id da tarefa a consultar. Especifique um task_id para retornar apenas o status dessa tarefa ou omita-o para consultar múltiplas tarefas.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

start_time

String

Não

Horário inicial da consulta no formato YYYYMMDDhhmmss. O padrão é 24 horas antes de end_time (se end_time for especificado) ou as últimas 24 horas (se nenhum horário for especificado). Intervalo máximo: 24 horas.

20230420193058 representa 19:30:58 em 20 de abril de 2023.

end_time

String

Não

Horário final da consulta no formato YYYYMMDDhhmmss. O padrão é 24 horas após start_time (se start_time for especificado). Intervalo máximo: 24 horas.

model_name

String

Não

Nome do modelo.

wanx-v1

status

String

Não

Status da tarefa:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• CANCELED

• UNKNOWN

page_no

Integer

Não

Número da página de resultados a retornar. Padrão: 1.

-

page_size

Integer

Não

Número de entradas por página. Padrão: 10.

-

request_id

String

id exclusivo desta requisição.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

data

Array

Lista de resultados da consulta.

"data": [
    {
        "api_key_id": "235",
        "caller_uid": "1808342417264262",
        "end_time": 1682527200093,
        "gmt_create": 1682514589152,
        "model_name": "paraformer-16k-1",
        "region": "cn-hangzhou",
        "request_id": "32b67b58-xxxx-xxxx-xxxx-230f0aee64d9",
        "start_time": 1682515862179,
        "status": "FAILED",
        "task_id": "cf52b16b-xxxx-xxxx-xxxx-17f9c211440c",
        "user_api_unique_key": "apikey:v1:audio:asr:transcription:paraformer-16k-1"
    }
]

data[].api_key_id

String

id da chave de API.

data[].caller_parent_id

String

id da conta Alibaba Cloud.

data[].caller_uid

String

id da conta Alibaba Cloud.

data[].gmt_create

Long

Horário de criação da tarefa (milissegundos desde a época Unix).

data[].start_time

Long

Horário de início da tarefa, em milissegundos desde a época Unix.

data[].end_time

Long

Horário de término da tarefa, em milissegundos desde a época Unix.

data[].region

String

Região. Exemplo: cn-hangzhou

data[].request_id

String

id da requisição de envio da tarefa.

data[].status

String

Status da tarefa:

• PENDING
• RUNNING
• SUCCEEDED
• FAILED
• CANCELED
• UNKNOWN

data[].task_id

String

id da tarefa.

data[].user_api_unique_key

String

Chave de API exclusiva gerada a partir dos parâmetros de API do modelo no momento do envio da tarefa.

data[].model_name

String

Nome do modelo.

page_no

Integer

Número da página atual.

"page_no": 1

page_size

Integer

Número de entradas por página.

"page_size": 10

total_page

Integer

Número total de páginas.

"total_page": 4

total

Integer

Número total de entradas.

"total": 39

code

String

Código de erro retornado quando a chamada falha.

"code": "Throttling.RateQuota"

message

String

Mensagem de erro retornada quando a chamada falha.

"message": "Requests rate limit exceeded, please try again later."

Header

Authorization

String

Sim

Chave de API no formato Bearer sk-xxx.

Bearer sk-xxx

Path

task_id

String

Sim

id da tarefa a cancelar.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

code

String

Código de erro retornado quando a chamada falha.

"code": "Throttling.RateQuota"

message

String

Mensagem de erro retornada quando a chamada falha.

"message": "Requests rate limit exceeded, please try again later."

400

UnsupportedOperation

Failed to cancel the task. Confirme that the task is in PENDING status.

Falha ao cancelar a tarefa. Apenas tarefas no estado PENDING podem ser canceladas.