Gerenciar tarefas assíncronas

Rastreie e controle trabalhos assíncronos

Alguns modelos (como geração de imagens e vídeos) são executados de forma assíncrona: você cria uma tarefa, obtém um ID e consulta o resultado com esse ID. Use essas APIs para consultar resultados, verificar o status em lotes e cancelar tarefas na fila.

Pré-requisitos

Chame essas APIs por HTTP.

Obtenha uma chave de API, então defina-o como uma variável de ambiente.

Consulta o resultado de uma tarefa assíncrona

Descrição da API: consulte o status e o resultado de uma tarefa por task_id.

Limite de taxa: 20 QPS por QwenCloud conta.

• Você pode consultar todas as tarefas sob o QwenCloud conta que possui a chave de API, incluindo tarefas de qualquer chave de API dessa conta. Você não pode consultar tarefas de outras contas.

• Os dados da tarefa concluída são retidos por 24 horas por padrão (verifique a referência específica da API para saber a duração exata) antes da exclusão automática.

Ponto de extremidade da solicitação

GET https://maas.qwencloudapi.com/api/v1/tasks/{task_id}

Parâmetros de solicitação

Parâmetros de resposta

Exemplo de solicitação

curl -X GET 'https://maas.qwencloudapi.com/api/v1/tasks/73205176-xxxx-xxxx-xxxx-16bd5d902219' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Se você não definiu a chave de API como variável de ambiente, substitua $DASHSCOPE_API_KEY com sua chave real. Exemplo: --header "Authorization: Bearer sk-ws-xxx".

Exemplo de resposta

{
  "request_id": "45ac7f13-xxxx-xxxx-xxxx-e03c35068d83",
  "output": {
    "task_id": "73205176-xxxx-xxxx-xxxx-16bd5d902219",
    "task_status": "SUCCEEDED",
    "submit_time": "2023-12-20 21:36:31.896",
    "scheduled_time": "2023-12-20 21:36:39.009",
    "end_time": "2023-12-20 21:36:45.913",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx1.png"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx2.png"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx3.png"
      },
      {
        "code": "DataInspectionFailed",
        "message": "Output data may contain inappropriate content."
      }
    ],
    "task_metrics": {
      "TOTAL": 4,
      "SUCCEEDED": 3,
      "FAILED": 1
    }
  },
  "usage": {
    "image_count": 3
  }
}

Consulte o status de múltiplas tarefas assíncronas

Descrição da API: consulte o status de várias tarefas de uma só vez por intervalo de tempo, modelo ou status.

Limite de taxa: 20 QPS por QwenCloud conta.

• Você pode consultar todas as tarefas sob o QwenCloud conta que possui a chave de API, incluindo tarefas de qualquer chave de API dessa conta. Você não pode consultar tarefas de outras contas.

• Os dados da tarefa concluída são retidos por 24 horas por padrão (verifique a referência específica da API para saber a duração exata) antes da exclusão automática.

Ponto de extremidade da solicitação

GET https://maas.qwencloudapi.com/api/v1/tasks/

Parâmetros de solicitação

Parâmetros de resposta

Exemplo de solicitação

curl -X GET 'https://maas.qwencloudapi.com/api/v1/tasks/?start_time=xxx&end_time=xxx&status=xxx' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Exemplo de resposta

{
  "total": 2,
  "data": [
    {
      "api_key_id": "15xxxx",
      "caller_parent_id": "xxxxxxxxx",
      "caller_uid": "xxxxxxxxx",
      "gmt_create": 1745568428109,
      "model_name": "wanx2.1-kf2v-plus",
      "region": "ap-southeast-1",
      "request_id": "1abfc3c8-dd25-98da-ad0b-xxxxxx",
      "start_time": 1745568428138,
      "status": "RUNNING",
      "task_id": "50e2ccea-abc4-43d7-a0dc-xxxxxx",
      "user_api_unique_key": "apikey:v1:aigc:image2video:video-synthesis:wanx2.1-kf2v-plus"
    },
    {
      "api_key_id": "15xxxx",
      "caller_parent_id": "xxxxxxxxx",
      "caller_uid": "xxxxxxxxx",
      "end_time": 1745568302481,
      "gmt_create": 1745568293253,
      "model_name": "wanx2.1-t2i-turbo",
      "region": "ap-southeast-1",
      "request_id": "f6bf34d9-bf87-9e8b-9ed4-xxxxxx",
      "start_time": 1745568293273,
      "status": "SUCCEEDED",
      "task_id": "3c777dbc-8cc6-4d80-aa90-xxxxxx",
      "user_api_unique_key": "apikey:v1:aigc:text2image:image-synthesis:wanx2.1-t2i-turbo"
    }
  ],
  "total_page": 1,
  "page_no": 1,
  "request_id": "f6756b7e-d0bb-9b74-813a-xxxxxx",
  "page_size": 10
}

Cancelar uma tarefa assíncrona

Descrição da API: Cancele uma tarefa em PENDING estado. As tarefas em outros estados não podem ser canceladas.

Limite de taxa: 20 QPS por QwenCloud conta.

• Você pode cancelar qualquer tarefa sob o QwenCloud conta que possui a chave de API, incluindo tarefas de qualquer chave de API dessa conta. Você não pode cancelar tarefas de outras contas.

Ponto de extremidade da solicitação

POST https://maas.qwencloudapi.com/api/v1/tasks/{task_id}/cancel

Parâmetros de solicitação

Parâmetros de resposta

Exemplo de solicitação

curl -X POST 'https://maas.qwencloudapi.com/api/v1/tasks/73205176-xxxx-xxxx-xxxx-16bd5d902219/cancel' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Exemplo de resposta

{
  "request_id": "45ac7f13-xxxx-xxxx-xxxx-e03c35068d83"
}

Códigos de erro