TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

3D

3D Model Durumunu Al

Bir 3D oluşturma görevinin durumunu ve sonucunu getirir

GET
/v1/tasks/{id}

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

idstringpathzorunlu

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.

idstring

Görev kimliği (ID).

task_idstring

Uygun olduğunda dönen asenkron görev kimliği takma adı.

poll_urlstring

Uygun olduğunda dönen öncelikli polling URL'si.

statusstring

Görev durumu: pending, processing, completed veya failed.

progressinteger

İ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.

model_urlstring

3D model dosyasını indirmek için URL (tamamlandığında).

glb_urlstring

GLB formatındaki modeli indirmek için URL (mevcut olduğunda).

fbx_urlstring

FBX formatındaki modeli indirmek için URL (mevcut olduğunda).

errorstring | object

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

Yanıt (Tamamlandı)
{
  "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
AuthorizationBearer <token>

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*string

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

3D Model Oluştur

Önceki

Görev Durumunu Al

Sonraki