Query Task API

API Overview

Used to query the current status and result of a 3D model split task by task ID.

Protocol	Endpoint	Method	Auth	Request Format	Response Format
HTTP	/open-api/v1/split/query-task	GET	Token	application/json	application/json

Request Headers

Parameter	Value	Description
Content-Type	application/json	Data exchange format
Authorization	Token	Replace {token} with the token you obtained

Request Parameters (HTTP GET)

Parameter	Type	Required	Description
task_id	string	Yes	Task ID returned by the create-task API result

https://api.hitem3d.ai/open-api/v1/split/query-task?task_id=split_20260312_8f92ab3e1cde

Response Body

Parameter	Field	Type	Description
code	-	int	Error code, see error code table
data	task_id	string	Task ID
	state	string	Processing status • created: task created • queueing: task queued • processing: task in progress • success: task completed • failed: task failed
	id	string	Generated artifact ID
	cover_url	string	Generated cover image URL, valid for one hour
	url	string	Generated split result URL, valid for one hour. For character split with joints, this field returns the joint result URL when available
msg	-	string	Detailed error message

{
  "code": 200,
  "data": {
    "task_id": "split_20260312_8f92ab3e1cde",
    "state": "success",
    "id": "split_20260312_8f92ab3e1cde_0",
    "cover_url": "https://example.com/cover.png",
    "url": "https://example.com/split/output/result.glb"
  },
  "msg": "success"
}

Error Codes

Error codes are returned in JSON structure, including code and msg.

{
  "code": 5001001,
  "data": {},
  "msg": "generate failed"
}

Error Code	Error Message	Error Description
5001001	generate failed	Timeout or model parsing failed. Retry later; credits are refunded

Request Example (Shell)

curl --location --request GET 'https://api.hitem3d.ai/open-api/v1/split/query-task?task_id=split_20260312_8f92ab3e1cde' \
--header 'Authorization: Token {{token}}' \
--header 'Content-Type: application/json'