2D to 3D Generator — SDK Guide

Photo-to-3D is an HTTP API, not a separate browser SDK.

Generate a model: API reference — POST /api/v1/shoe-3d and GET /api/v1/jobs/{jobId}
Put try-on on a website: hosted shoe AR guide at tryon.wearfits.com/docs/integration-shoes
AR viewer parameters and iframe: Shoes & Bags AR SDK

Sandbox for manual tests: tryon.wearfits.com/shoes.

Shoe 3D upload ownership

When uploadToWearFits is enabled on POST /api/v1/shoe-3d, WEARFITS files the generated model in one library. Choose one ownership mechanism per upload:

Account-attributed upload: If the credential used for the request is associated with a WEARFITS account, the model is filed in that account's library automatically. No account identifier or ownership parameter is required.
Explicit session attribution: A frontend application can set options.sessionId to an existing WEARFITS user session. The model is then linked to that session.

options.sessionId takes precedence. When it is provided, it is the only ownership claim used for the upload; the account associated with the credential is not used. If neither mechanism is provided, the model is filed in the default library associated with the integration.

Account-attributed upload:

{
  "options": {
    "uploadToWearFits": true
  }
}

Explicit session attribution:

{
  "options": {
    "uploadToWearFits": true,
    "sessionId": "wearfits-session-id"
  }
}

WEARFITS upload size

Generated GLB uploads to WEARFITS have a 20 MB per-account limit. Treat 20 MB as the supported upload ceiling. When uploadToWearFits is enabled, the pipeline compresses models for this limit when possible; a model that remains larger than 20 MB cannot be uploaded.