Hitem3D

Hitem3D 3.0 reconstructs detailed, watertight 3D models at 2048³ resolution from a single reference image or from 2–4 views of the same object. Quality mode balances detail and cost; Master mode targets maximum geometric fidelity with up to 5 million faces. Hitem3D is image-guided only and does not accept text prompts. Output is always GLB.

/v1/3d-models/hitem3d/image-to-3d/

Generate a 3D model from a single reference image. Quality mode typically finishes in about 2 minutes; Master mode can take up to 20 minutes.

curl -X POST https://api.3daistudio.com/v1/3d-models/hitem3d/image-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/reference.png",
    "resolution": "2048quality",
    "texture": true,
    "pbr": true,
    "shading": 0.5
  }'

{
  "task_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
  "created_at": "2026-09-29T12:00:00Z"
}

/v1/3d-models/hitem3d/multiview-to-3d/

Generate a 3D model from 2–4 views of the same object. Views are passed by name, so partial sets such as front + left are placed correctly. Multi-angle input improves 360° shape accuracy and costs the same as a single image.

curl -X POST https://api.3daistudio.com/v1/3d-models/hitem3d/multiview-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "views": {
      "front": { "image_url": "https://example.com/front.png" },
      "back":  { "image_url": "https://example.com/back.png" },
      "left":  { "image_url": "https://example.com/left.png" },
      "right": { "image_url": "https://example.com/right.png" }
    },
    "resolution": "2048quality",
    "texture": true,
    "pbr": true
  }'

{
  "task_id": "b8c9d0e1-f2a3-4567-1234-678901234567",
  "created_at": "2026-09-29T12:00:00Z"
}

Accepts resolution, texture, pbr, shading and face_limit exactly as in the Image to 3D table above, plus the views object.

Use images of the same object at the same scale and lighting, ideally orthographic views on a clean background: front facing the camera, back rotated 180°, and left and right side views. Every view is required to load: if any image cannot be downloaded or is not PNG, JPEG or WebP, the whole request fails and its credits are refunded, rather than generating from fewer views than you sent. Image URLs for one request must finish downloading within 120 seconds combined; for slow hosts, send the images as base64 instead.

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the generation response. When status is "FINISHED", the results array contains a download URL for your GLB model. Results expire after 24 hours. If status is "FAILED", failure_reason explains why (for example, which view could not be downloaded).

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "status": "FINISHED",
  "progress": 100,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/model.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    }
  ]
}

Pricing depends on resolution and whether textures are generated. PBR, de-shading, face_limit and the number of views do not change the price, and Image to 3D and Multiview to 3D cost the same. Credits are deducted on submission and refunded automatically on failure.

Common errors for Hitem3D generation endpoints. Validation errors list their messages per request field; messages about a specific view are prefixed with the view name (for example "left: ..."). No credits are charged for rejected requests.

{
  "errors": {
    "views": ["The front view is required."]
  },
  "error_code": "VALIDATION_FAILED"
}