Görev Sorgusu

task_id ile bir eşzamansız Tripo görevinin durumunu, ilerlemesini ve çıktısını sorgulayın.

Tüm oluşturma, mesh işleme, rigging, animasyon, dosya içe aktarma ve dönüştürme uç noktaları bir task_id döndürür. Görev success, failed veya cancelled’ye ulaşana kadar yoklama yapmak için bu uç noktayı kullanın.

Uç nokta

HTTP

GET /v3/tasks/{task_id}

Yol Parametreleri

İsim	Tür	Gerekli	Açıklama
`task_id`	dize	gerekli	Görev oluşturma uç noktası tarafından döndürülen benzersiz görev tanımlayıcısı. Genellikle `task_` ile başlar.

Örnek Talep

Bash

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

Yanıt Alanları

Alan	Tür	Açıklama
`task_id`	dize	Benzersiz görev tanımlayıcısı.
`type`	dize	`text_to_model`, `image_to_model`, `rig` veya `convert` gibi görev türü.
`status`	dize	`queued`, `running`, `success`, `failed` veya `cancelled`’den biri.
`progress`	tamsayı	`0`’den `100`’ye görev ilerlemesi.
`output`	nesne	`status=success` olduğunda doldurulur; `model_url`, `rendered_image_url` veya göreve özgü diğer varlıkları içerebilir. Model içe aktarma ve model girdisi `file_token` veya URL olan model son işleme görevleri (rigging, doku, dönüştürme vb.) ayrıca `normalize_scale` (number) döndürür: içe aktarılan model normalleştirilirken uygulanan ölçek katsayısı (`son boyut = orijinal boyut × normalize_scale`; `1.0` ölçeklendirme yok demektir).
`credits_consumed`	number	Tamamlanan görev tarafından tüketilen krediler.
`created_at`	dize	ISO 8601 oluşturma zamanı.
`completed_at`	dize	Mevcut olduğunda ISO 8601 tamamlanma süresi.

Durum İşleme

queued ve running’yi tamamlanmamış durumlar olarak ele alın.
Çıkış varlıklarını yalnızca status=success’den sonra indirin.
failed veya cancelled’yi kullanıcıya gösterin ve girişi değiştirmeden yeniden deneme döngülerinden kaçının.