3D

Mendapatkan Status Model 3D

Mengambil status dan hasil dari tugas pembuatan 3D

GET
/v1/tasks/{id}

GET /v1/3d/generations/{id} adalah endpoint kompatibilitas. Endpoint ini tetap didukung untuk integrasi yang sudah ada. Integrasi baru harus melakukan polling ke GET /v1/tasks/{id}; lihat Mendapatkan Status Tugas.

Panggil GET /v1/tasks/{id} untuk memeriksa status tugas pembuatan model 3D Anda.

id dan task_id mengidentifikasi tugas yang sama.

Tugas publik yang kedaluwarsa atau tidak tersedia dapat mengembalikan 404 async_task_not_found. Jika kepemilikan tugas tidak dapat dipastikan untuk API key saat ini, respons yang diberikan adalah 403 task_not_owned.

Parameter Path

idstringpathwajib

ID tugas pembuatan 3D.

Respons

Bidang yang menjelaskan hasil, kesalahan, stempel waktu, dan model akan dikembalikan jika tersedia untuk tugas tersebut.

idstring

ID Tugas.

task_idstring

Alias pengenal tugas asinkron jika disediakan.

poll_urlstring

URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.

statusstring

Status tugas: pending, processing, completed, failed, atau timeout. Tugas yang gagal tetap mengembalikan HTTP 200.

progressinteger

Nilai progres opsional. Hanya dikembalikan jika nilai progres yang sebenarnya tersedia; gunakan status untuk menentukan penyelesaian.

model_urlstring

URL untuk mengunduh file model 3D (saat selesai). Tautan hasil media TokenLab yang tetap valid selama 30 hari.

glb_urlstring

URL untuk mengunduh model format GLB (saat tersedia).

fbx_urlstring

URL untuk mengunduh model format FBX (saat tersedia).

errorstring | object

Pesan kesalahan (saat gagal).

error_detailsobject

Detail kegagalan saat tugas gagal: status, message, type, code, retryable, dan param jika bidang permintaan bermasalah.

media_retentionobject

Status penyimpanan tautan hasil: days dan items[] dengan url, kind, status, dan expires_at. Bidang ini bisa saja tidak ada; tautan tetap berfungsi. Lihat Retensi data.

Permintaan

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Respons

Response (Completed)
{
  "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"
      }
    ]
  }
}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

id*string

ID tugas asinkron yang dikembalikan oleh id / task_id, atau disematkan dalam poll_url

Respons

application/json

application/json

application/json

application/json

application/json

application/json

application/json