Developers

Image-to-3D API

Two endpoints: submit a generation, poll until it's done. Each successful generation costs $0.35 from your prepaid balance — failed generations are refunded automatically. Top up on the pricing page; create keys on your dashboard.

Authentication

Pass your API key as a bearer token. Keys are shown once at creation and can be revoked anytime from the dashboard.

Authorization: Bearer l3d_your_api_key

Create a generation

POST /api/v1/generations — the image must be a publicly fetchable URL. One clear object on a plain background works best (see the input guide).

curl -X POST https://YOUR_DOMAIN/api/v1/generations \
  -H "Authorization: Bearer l3d_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/concept-art.png",
    "texture_size": 1024,
    "seed": 42
  }'

# → 201
# { "id": "8b1e2f…", "status": "queued" }

• image_url (required) — http(s) URL of the input image
• texture_size (optional) — 1024 (default) or 2048
• seed (optional) — integer, for reproducible results

Poll for the result

GET /api/v1/generations/{id} — poll every few seconds. Generation typically takes 3–6 minutes (longer on a cold start).

curl https://YOUR_DOMAIN/api/v1/generations/8b1e2f… \
  -H "Authorization: Bearer l3d_your_api_key"

# while running:
# { "id": "8b1e2f…", "status": "generating", … }

# when finished:
# {
#   "id": "8b1e2f…",
#   "status": "completed",
#   "glb_url":     "https://…/outputs/….glb",
#   "stl_url":     "https://…/outputs/….stl",
#   "obj_zip_url": "https://…/outputs/….obj.zip",
#   "error": null,
#   "created_at": "2026-07-13T…"
# }

Output formats

• GLB — full mesh with PBR textures; imports into Unity, Unreal, Godot, Blender, three.js
• STL — geometry only, ready for 3D-printing slicers
• OBJ (zip) — OBJ + MTL + textures for legacy DCC pipelines

Errors

• 401 — missing/invalid/revoked API key
• 402 — balance too low ("code": "payment_required"); top up and retry
• 400 — invalid request body
• A failed generation status means you were refunded — check error for the reason