# Consulta de tarefa

Consulte o status, o progresso e a saída de uma tarefa assíncrona Tripo por `task_id`.

Todos os endpoints de geração, processamento de malha, rigging, animação, importação de arquivo e conversão retornam um `task_id`. Use esse terminal para sondar até que a tarefa atinja `success`, `failed` ou `cancelled`.

## Ponto final

```http
GET /v3/tasks/{task_id}
```

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `task_id` | cadeia | obrigatório | Identificador de tarefa exclusivo retornado por um endpoint de criação de tarefa. Geralmente começa com `task_`. |

## Exemplo de solicitação

```bash
curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123
```

## Campos de resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `task_id` | cadeia | Identificador exclusivo da tarefa. |
| `type` | cadeia | Tipo de tarefa, como `text_to_model`, `image_to_model`, `rig` ou `convert`. |
| `status` | cadeia | Um de `queued`, `running`, `success`, `failed` ou `cancelled`. |
| `progress` | inteiro | Progresso da tarefa de `0` para `100`. |
| `output` | objeto | Preenchido quando `status=success`; pode incluir `model_url`, `rendered_image_url` ou outros ativos específicos de tarefas. |
| `credits_consumed` | inteiro | Créditos consumidos pela tarefa concluída. |
| `created_at` | cadeia | ISO 8601 hora de criação. |
| `completed_at` | cadeia | ISO 8601 tempo de conclusão quando disponível. |

## Tratamento de status

- Trate `queued` e `running` como estados inacabados.
- Baixe os ativos de saída somente após `status=success`.
- Mostre `failed` ou `cancelled` ao usuário e evite repetir loops sem alterar a entrada.