3D
3D Model Durumunu Al
Bir 3D oluşturma görevinin durumunu ve sonucunu alır
GET /v1/3d/generations/{id} bir uyumluluk uç noktasıdır. Mevcut entegrasyonlar için desteklenmeye devam etmektedir. Yeni entegrasyonlar GET /v1/tasks/{id} uç noktasını sorgulamalıdır; bkz. Görev Durumunu Al.
3D model oluşturma görevinizin durumunu kontrol etmek için GET /v1/tasks/{id} çağrısı yapın.
id ve task_id aynı görevi tanımlar.
Süresi dolmuş veya kullanılamayan bir genel görev 404 async_task_not_found döndürebilir. Mevcut API anahtarı için görev sahipliği doğrulanamazsa, yanıt 403 task_not_owned olur.
Yol Parametreleri
3D oluşturma görev kimliği (ID).
Yanıt
Sonuçları, hataları, zaman damgalarını ve modeli açıklayan alanlar, görev için mevcut olduklarında döndürülür.
Görev kimliği.
Sağlandığında asenkron görev tanımlayıcı takma adı.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.
Görev durumu: pending, processing, completed, failed veya timeout. Başarısız bir görev yine de HTTP 200 döndürür.
İsteğe bağlı ilerleme değeri. Yalnızca gerçek bir ilerleme değeri mevcut olduğunda döndürülür; tamamlanma durumunu belirlemek için status alanını kullanın.
3D model dosyasını indirmek için URL (tamamlandığında). 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.
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).
Görev başarısız olduğunda hata detayları: status, message, type, code, retryable ve bir istek alanı hatalıysa param.
Sonuç bağlantılarının saklama durumu: days ve url, kind, status ve expires_at içeren items[]. Bu alan bulunmayabilir; bağlantılar yine de çalışır. Bkz. Veri saklama.
İ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://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}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
application/json
application/json
application/json