Interrogazione attività

Interrogare lo stato, l’avanzamento e l’output di un’attività asincrona Tripo tramite task_id.

Tutti gli endpoint di generazione, elaborazione mesh, rigging, animazione, importazione di file e conversione restituiscono un task_id. Utilizza questo endpoint per eseguire il polling finché l’attività non raggiunge success, failed o cancelled.

Punto finale

HTTP

GET /v3/tasks/{task_id}

Parametri del percorso

Nome	Digitare	Obbligatorio	Descrizione
`task_id`	stringa	richiesto	Identificatore univoco dell’attività restituito da un endpoint dell’attività di creazione. Di solito inizia con `task_`.

Richiedi esempio

Bash

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

Campi di risposta

Campo	Digitare	Descrizione
`task_id`	stringa	Identificatore univoco dell’attività.
`type`	stringa	Tipo di attività, ad esempio `text_to_model`, `image_to_model`, `rig` o `convert`.
`status`	stringa	Uno tra `queued`, `running`, `success`, `failed` o `cancelled`.
`progress`	intero	Avanzamento dell’attività da `0` a `100`.
`output`	oggetto	Compilato quando `status=success`; può includere `model_url`, `rendered_image_url` o altre risorse specifiche dell’attività. Importa modello e le attività di post-elaborazione del modello (rigging, texturing, conversione, ecc.) con modello in input come `file_token` o URL restituiscono anche `normalize_scale` (number): il fattore di scala applicato durante la normalizzazione del modello importato (`dimensione finale = dimensione originale × normalize_scale`; `1.0` indica nessun ridimensionamento).
`credits_consumed`	number	Crediti consumati dall’attività completata.
`created_at`	stringa	ISO 8601 ora di creazione.
`completed_at`	stringa	ISO 8601 ora di completamento quando disponibile.

Gestione dello stato

Tratta queued e running come stati non finiti.
Scarica le risorse di output solo dopo status=success.
Presenta failed o cancelled all’utente ed evita cicli di tentativi senza modificare l’input.