3D
Mendapatkan Status Model 3D
Mengambil status dan hasil dari tugas pembuatan 3D
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
ID tugas pembuatan 3D.
Respons
Bidang yang menjelaskan hasil, kesalahan, stempel waktu, dan model akan dikembalikan jika tersedia untuk tugas tersebut.
ID Tugas.
Alias pengenal tugas asinkron jika disediakan.
URL status untuk tugas ini. Lakukan polling GET /v1/tasks/{id} dengan id.
Status tugas: pending, processing, completed, failed, atau timeout. Tugas yang gagal tetap mengembalikan HTTP 200.
Nilai progres opsional. Hanya dikembalikan jika nilai progres yang sebenarnya tersedia; gunakan status untuk menentukan penyelesaian.
URL untuk mengunduh file model 3D (saat selesai). Tautan hasil media TokenLab yang tetap valid selama 30 hari.
URL untuk mengunduh model format GLB (saat tersedia).
URL untuk mengunduh model format FBX (saat tersedia).
Pesan kesalahan (saat gagal).
Detail kegagalan saat tugas gagal: status, message, type, code, retryable, dan param jika bidang permintaan bermasalah.
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
{
"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 Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
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