3D

3D Model Durumunu Al

Bir 3D oluşturma görevinin durumunu ve sonucunu alır

GET
/v1/tasks/{id}

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

idstringpathzorunlu

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.

idstring

Görev kimliği.

task_idstring

Sağlandığında asenkron görev tanımlayıcı takma adı.

poll_urlstring

Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.

statusstring

Görev durumu: pending, processing, completed, failed veya timeout. Başarısız bir görev yine de HTTP 200 döndürür.

progressinteger

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

model_urlstring

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_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).

error_detailsobject

Görev başarısız olduğunda hata detayları: status, message, type, code, retryable ve bir istek alanı hatalıysa param.

media_retentionobject

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

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

application/json

application/json

application/json