Skip to content
Documentation

Add Try-On in one line

Everything you need to put Beehive on a store, demo it on any site, or connect to the stream yourself.

<!-- on every product page -->

<script src="https://beehive-live.vercel.app/embed/tryon.js"

data-key="YOUR_SITE_KEY" async></script>

1 · Store embed

Install

Add the script tag above to the product listing and product detail pages. It loads asynchronously and does nothing until a shopper presses Try-On. Your site key is publishable; it only works from your domain and can be revoked.

2 · Marking product photos

Choose which images get a button

Mark each product image you want to offer for try-on. Optional attributes give the product's name and a cleaner image to use as the reference.

<img src="jacket.jpg" data-beehive-tryon
     data-beehive-title="Faux Leather Moto Jacket"
     data-beehive-src="jacket-front-white.jpg">
  • Front view
    The whole item, facing the camera
  • Plain background
    White or light grey works best
  • Small items
    Add a photo of the piece being worn

3 · Session limits

Short sessions, predictable cost

Each Try-On session lasts 30 seconds by default; shoppers can press Resume for another. Set a different length with data-session-seconds on the script tag. Before connecting, the panel checks that the service is available and shows a friendly message if it is not.

4 · Chrome extension

Demo on any retailer's site

The Beehive Try-On extension adds the same button to product images on any website, for sales demos before a store has installed the embed. It uses an API key entered in the extension's settings.

5 · Streaming API PREVIEW

One stream in, one stream out

  1. 01
    Get a pass. Your server calls the session endpoint with your API key and receives a short-lived pass for the browser.
  2. 02
    Open the stream. The browser opens a WebSocket with the pass and waits for its turn on the GPU.
  3. 03
    Start. Send the instruction, output size, frame rate and an optional reference image.
  4. 04
    Stream. Send camera frames as JPEG; receive edited frames back, acknowledging every few frames so the stream never builds up lag.

The API is in preview. Contact us for access and the full reference.

Integration questions

Does the embed slow down my store?add

No. The script loads asynchronously, adds small buttons, and only opens a camera panel when a shopper asks for it.

Which platforms are supported?add

Any store where you can add a script tag to product pages, including custom sites and most hosted e-commerce platforms.

Where do I get a site key?add

We issue keys during a pilot. Request one here.