Skip to main content
Give your character a reference image for the product you want it to show. Register the image when you create the session so it is available from the first conversation.

1. Try the Bluetooth speaker example

Open Avatar Playground and choose Object interaction. The example includes Olivia, a shopping host, and a registered Bluetooth speaker image. The scene starts with an empty table. Go live and ask: “Could you introduce the Bluetooth speaker?” Then say “Put it away, please.” After she puts it away, check that the speaker stays out of view and her hands are empty.

2. Register your product at session creation

Add the reference under assets.images in your Create Session request. This fragment uses the speaker from Playground; replace its URL and description with your own product details.
Use a public HTTPS URL that Vivix can fetch without custom headers. The reference should show the product clearly. Choose a starting image with visible hands and enough space to present it.

3. Name and describe each reference

Use OBJ_0, OBJ_1, … as image asset IDs, with a different number for each object. Keep each ID attached to the same product throughout the session. description is optional. If you include it, use the matching tag: an asset named OBJ_0 should include <OBJ_0> in its description. The asset ID has no angle brackets; the tag in the description does. Describe the object’s visible appearance: its shape, color, material, and distinctive features. Keep the description factual and consistent with the image. For example, a dark gray cylindrical Bluetooth speaker<OBJ_0> with a perforated grille is enough to identify the product. Leave requested actions and sales claims out of the image description. For multiple products, give each one a distinct name and description so the character can tell them apart.

4. Add products during a live session

If a product becomes available after the session starts, register it with asset.add. Wait for asset.added before asking the character to use it. Use the same naming and description rules as above.