---
title: 2D to 3D Generator — SDK Guide
product: shoe3d-generator
last_updated: '2026-09-21'
description: "Photo-to-3D is an HTTP API, not a separate browser SDK."
---

# 2D to 3D Generator — SDK Guide

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

- **Generate a model:** [API reference](api-reference.md) — `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](https://tryon.wearfits.com/docs/integration-shoes)
- **AR viewer parameters and iframe:** [Shoes & Bags AR SDK](../ar-tryon/sdk-guide.md)

Sandbox for manual tests: [tryon.wearfits.com/shoes](https://tryon.wearfits.com/shoes).

API keys: [dash.wearfits.com](https://dash.wearfits.com).

## 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:

```json
{
  "options": {
    "uploadToWearFits": true
  }
}
```

Explicit session attribution:

```json
{
  "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.