Error handling
Distinguish HTTP request failure from an asynchronous failed state, then inspect the endpoint’s code and message. After a network timeout, query the original task_id before creating another task.
| Case | Check and action |
|---|---|
| Authentication failure | Check the request domain, API credentials, access token and authorization scheme |
| Parameter or file error | Check the endpoint’s model, resolution, exclusive/conditional parameters, format and file limits |
| Insufficient credits | 30010000: check available credits and purchase the required package on this site |
| Generation failure | 5001001: Generation failed due to a timeout or input parsing failure. Consumed credits have been refunded. |
| Callback not received | Check the callback URL, receiver logs, and original task. See the Webhook delivery policy. |
General 3D creation errors
| code | msg | Description |
|---|---|---|
| 30010000 | balance is not enough | Insufficient credit balance |
| 10031001 | Upload file size exceeds limit | Uploaded file exceeds 20 MB |
| 10031002 | Face not valid | Invalid face count. Check the face range and recommended values in the request body. |
| 10031003 | Resolution not valid | Resolution is not supported by the model |
| 10031004 | request type not support | Unsupported request type |
| 10031005 | images only allow png jpeg jpg webp | Unsupported image format |
| 10031006 | model not valid | Unsupported model identifier |
| 10031007 | both images and multi images provided | Single-image and multi-view inputs cannot both be provided |
| 10031008 | images or multi images required | Provide a single-image or multi-view input |
| 10031009 | multi images count exceeds limit | At most four multi-view images |
| 10031010 | empty file not allowed | Empty file; check form upload encoding |
| 10031011 | mesh url or mesh required when request type 2 | Texture generation requires mesh_url or mesh |
| 10031012 | mesh_url_must_start_with_http | mesh_url must start with http |
| 10031013 | multi images bit length error | multi_images_bit must contain four positions |
| 10031014 | multi images bit invalid char error | multi_images_bit accepts only 0/1 |
| 10031015 | multi_images_bit_count_mismatch_error | The number of 1s must match the image count |
| 10031016 | mesh format not supported | mesh and mesh_url support only GLB |
| 10031017 | model does not support texture | The requested model does not support texturing (request_type=2). |
| 10000000 | system error | Internal system error |
Authentication → · Full image-to-3D parameters →
API support:apicontact@hi3d.ai