3D
3D Model Durumunu Al
Bir 3D oluşturma görevinin durumunu ve sonucunu getirir
3D model oluşturma görevinizin durumunu kontrol etmek için bu uç noktayı sorgulayın.
Create yanıtı poll_url içeriyorsa, sorgulama için doğrudan o URL'yi kullanın. id ve task_id aynı asenkron görev kimliği olarak değerlendirilmelidir.
Süresi dolmuş veya kullanılamayan bir görev 404 async_task_not_found döndürebilir. Geçerli API anahtarının görev sahipliği doğrulanamazsa yanıt 403 task_not_owned olur.
Yol Parametreleri
3D oluşturma görevi kimliği (ID).
Yanıt
Sonuç, hata, zaman damgası ve model alanları görev için mevcut olduğunda döndürülür.
Görev kimliği (ID).
Uygun olduğunda dönen asenkron görev kimliği takma adı.
Uygun olduğunda dönen öncelikli polling URL'si.
Görev durumu: pending, processing, completed veya failed.
İsteğe bağlı ilerleme değeri. Yalnızca gerçek bir ilerleme değeri varsa döner; tamamlanmayı belirlemek için status kullanın.
3D model dosyasını indirmek için URL (tamamlandığında).
GLB formatındaki modeli indirmek için URL (mevcut olduğunda).
FBX formatındaki modeli indirmek için URL (mevcut olduğunda).
Hata mesajı (başarısız olduğunda).
İstek
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Yanıt
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://cdn.tripo3d.ai/abc123.glb",
"glb_url": "https://cdn.tripo3d.ai/abc123.glb",
"fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
id / task_id tarafından döndürülen veya poll_url içine gömülü olan asenkron görev kimliği
Yanıt
application/json
application/json
application/json
application/json