Frequently Asked Questions (FAQ)

Hitem3D API Usage Questions

What are the prerequisites for calling the API?

Before making production API calls, sign in to the Open Platform, activate a test resource package or purchase a production resource package, and create an API Key.

How do I purchase an API resource package?

After signing in, go to Resource Packages on the platform to purchase a package.

How do I obtain an API Key?

After signing in, create and manage API Keys on the API Key Management page.

How do I make an API call?

Use HTTPS with the POST method.

• Authentication: Put your API Key in the Authorization header to call the Get Token endpoint.
• Create task: Include the Token in the Authorization header when calling the Create Task endpoint, and provide required body parameters such as request type (geometry-only / phased / one-shot), image input type and files (single-view / multi-view), model resolution, target polygon count, and output format.

See the API Reference for full parameter details.

Concurrency & rate limits?

Default 10 concurrent tasks. For higher concurrency, contact apicontact@hitem3d.ai.

How to check task status and download results?

Poll the task or configure a Webhook to receive status updates. When status=success, the response includes the generated asset ID, cover/preview info, and download URLs (model + textures).

Does the API support batch generation?

Each call creates one task only.

How to troubleshoot common errors?

1. Check network connectivity
2. Verify image format/size limits
3. Ensure sufficient credit balance
4. For multi-view, include the required front view
5. If the queue is busy, reduce concurrency or retry later

If issues persist, follow the error message guidance or contact apicontact@hitem3d.ai.

Are credits charged on failed calls?

No. For server faults/timeouts/parameter-validation failures, credits are refunded or not deducted (timeout threshold: 60 minutes).

See the error code for the failure type.

Hitem3D Model Questions

Generation modes and types?

• Modes: Image to 3D, Multi-view to 3D.
• Types: Geometry-only; Phased generation (geometry → texture); One-shot (geometry + texture).

Input image format and size limits?

• Formats: png, jpeg/.jpg, webp.
• Size: Up to 20 MB per image.

Limits on number of input images?

Varies by Modes：

• Single-view to 3D: 1 image.
• Multi-view to 3D: 2–4 images; front view is required. Including back/left/right is recommended for a more detailed and complete 3D model.

Supported resolutions?

512³, 1024³, 1536³, 1536³ Pro. Higher resolutions yield more detail and larger files, with longer inference time.

Polygon count?

You can set the target polygon count in 100,000–2,000,000. Recommended presets:

• 512³: 500,000
• 1024³: 1,000,000
• 1536³: 2,000,000

Output formats?

Common 3D formats: glb, obj, stl, fbx; textures: JPG, PNG. Outputs can be used directly in game engines or for 3D printing.