Skip to main content
GET
Get 3D model job status

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Path Parameters

job_id
string
required

The job id returned by the create endpoint.

Response

Current job status. The file URLs are populated once succeeded.

created_at
string<date-time>
credits
integer
error
string
files
object

Every format produced, by kind — glb always; Meshy also fbx, usdz, stl, and with rigging rigged_glb, rigged_fbx, animation_glb, animation_fbx.

id
string
model
string
model_url
string<uri>

The full 3D model as GLB (signed URL, valid several hours); present once status=succeeded.

preview_model_url
string<uri>

A light copy of the GLB for web viewers (simplified, meshopt-compressed, WebP textures).

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout
thumbnail_url
string<uri>

A rendered picture of the model.