Developers — Build with Vizbl

developer.vizbl.com

The full developer portal

SDK downloads, OpenAPI spec, sandbox API keys, tutorials, change-log, status page and a hands-on console for testing requests.

REST API Web SDK iOS Android Webhooks

Quickstart

From zero to AR in three steps.

Drop a script tag, point at a model id, and you have a working 3D + AR viewer on your page. Total time: under 5 minutes.

Step 1

Add the script

Load the Vizbl viewer once from our CDN. It's tree-shaken and async by default.

<script
  type="module"
  src="https://cdn.vizbl.com/v1/viewer.js">
</script>

Step 2

Drop the element

Use the <vizbl-viewer> web component anywhere on your page.

<vizbl-viewer
  model-id="sofa_halden"
  ar
  scale="auto">
</vizbl-viewer>

Step 3

Hook the AR button

Add your own button with slot="ar". Vizbl handles the rest.

<vizbl-viewer model-id="…" ar>
  <button slot="ar">
    View in your room
  </button>
</vizbl-viewer>

REST API

Manage your catalog programmatically.

Upload models, attach them to SKUs, rotate variants, and read analytics, all over a clean JSON API. Authenticate with a server-side API key.

✓ModelsPOST /v1/models, upload a GLB or photo set, get a model_id back.
✓ProductsPUT /v1/products/:sku/model, attach a model to a SKU.
✓VariantsColor, finish and material switching from one source model.
✓AnalyticsGET /v1/analytics/sessions, views, AR launches, dwell time.
✓WebhooksGet notified when AI 3D generation completes or fails.

Full API reference ↗

# Upload a model from photos
curl https://api.vizbl.com/v1/models \
  -H "Authorization: Bearer $VIZBL_KEY" \
  -F "name=Halden Sofa" \
  -F "photos[]=@front.jpg" \
  -F "photos[]=@side.jpg" \
  -F "photos[]=@back.jpg"

# Attach to a SKU
curl -X PUT \
  https://api.vizbl.com/v1/products/SOFA-001/model \
  -H "Authorization: Bearer $VIZBL_KEY" \
  -d '{"model_id":"mdl_5b9c…"}'

# Read analytics
curl https://api.vizbl.com/v1/analytics/sessions \
  -H "Authorization: Bearer $VIZBL_KEY"

Mobile SDKs

Native iOS & Android, in two lines.

Render Vizbl AR experiences inside your own app. Surface AR launches from product detail screens, push notifications or universal links.

iOS · Swift

VizblKit

import VizblKit

VizblViewer
  .model("sofa_halden")
  .ar(.enabled)
  .present(from: viewController)

Android · Kotlin

vizbl-android

val intent = VizblViewer.builder()
  .modelId("sofa_halden")
  .enableAR(true)
  .build(context)

context.startActivity(intent)

Deep links

Universal links open AR straight from email, push, social or QR, across web, iOS and Android.

Webhooks

Subscribe to model.ready, model.failed and session.completed. Hooks are signed with HMAC.

Status & SLAs

Realtime status page, multi-region failover, and 99.9% uptime SLA on Enterprise plans.

Build with Vizbl.