Documentation

Everything you need to integrate Inertia's AI styling engine into your application, from quick-start guides to full API reference.

Quick Start

Get up and running with Inertia in three simple steps. Whether you're building a fashion app or integrating styling recommendations into an existing platform, this guide covers the essentials.

Take the Style Quiz

Submit visual preferences via the Style Quiz API. Our AI maps responses to a 64-dimension style profile in under 2 seconds.

Upload Your Closet

Send wardrobe images to the Closet AI endpoint. Computer vision catalogs every piece, identifying color, fabric, style, and condition.

Get Your Picks

Request personalized outfit recommendations. The engine combines Style DNA, wardrobe data, and trend analysis for each pick.

Authentication

All API requests require a Bearer token. Obtain your API key from the Developer Dashboard.

bash

# Set your API key
export INERTIA_API_KEY="ik_live_your_api_key_here"

# Test your connection
curl -H "Authorization: Bearer $INERTIA_API_KEY" \
  https://api.inertiaclothing.net/v1/status

Base URL for all endpoints:

url

https://api.inertiaclothing.net/v1

API Reference

The Inertia API follows RESTful conventions. All requests and responses use JSON. Rate limits are 100 requests/minute for Free, 1,000 for Premium, and unlimited for VIP plans.

POST /style-quiz

POST /v1/style-quiz

Submit style quiz responses to generate a user's Style DNA profile. Returns a 64-dimension style vector and top style archetypes.

Parameter	Type	Status	Description
`user_id`	string	Required	Unique user identifier
`responses`	array	Required	Array of quiz answer objects
`preferences`	object	Optional	Budget, size, and brand preferences

json

{
  "user_id": "usr_abc123",
  "responses": [
    { "question_id": "q1", "choice": "minimal_warm" },
    { "question_id": "q2", "choice": "earth_tones" },
    { "question_id": "q3", "choice": "relaxed_fit" }
  ],
  "preferences": {
    "budget": "mid_range",
    "sustainability": true
  }
}

GET /recommendations

GET /v1/recommendations/{user_id}

Retrieve personalized outfit and item recommendations based on the user's Style DNA and wardrobe data.

Parameter	Type	Status	Description
`user_id`	string	Required	Path parameter, user identifier
`limit`	integer	Optional	Number of recommendations (default: 10)
`occasion`	string	Optional	Filter by occasion type
`include_owned`	boolean	Optional	Include items from user's closet

POST /try-on

POST /v1/try-on

Generate a virtual try-on rendering for a specific item on a user's body profile. Returns a high-resolution image URL.

Parameter	Type	Status	Description
`user_id`	string	Required	Unique user identifier
`item_id`	string	Required	Product item to try on
`photo_url`	string	Optional	Custom user photo (or uses profile)
`resolution`	string	Optional	"standard" or "high" (Premium+)

GET /wardrobe

GET /v1/wardrobe/{user_id}

Retrieve the user's digitized wardrobe, including AI-detected categories, colors, style tags, and outfit combination suggestions.

Parameter	Type	Status	Description
`user_id`	string	Required	Path parameter, user identifier
`category`	string	Optional	Filter by clothing category
`sort`	string	Optional	"recent", "color", "frequency"

Code Examples

Full integration examples to get you started quickly.

JavaScript / Node.js

javascript

import Inertia from '@inertia/style-sdk';

const client = new Inertia({
  apiKey: process.env.INERTIA_API_KEY
});

// Get personalized recommendations
const picks = await client.recommendations.list({
  userId: 'usr_abc123',
  limit: 5,
  occasion: 'business_casual'
});

console.log(picks.data);
// [{ item_id: "itm_001", name: "Wool Blazer", match: 0.97, ... }]

Python

python

import inertia

client = inertia.Client(api_key="ik_live_your_key")

# Submit style quiz and get Style DNA
profile = client.style_quiz.submit(
    user_id="usr_abc123",
    responses=[
        {"question_id": "q1", "choice": "minimal_warm"},
        {"question_id": "q2", "choice": "earth_tones"},
    ]
)

print(profile.style_dna)
# { archetypes: ["Coastal Minimalist", "Modern Classic"], vector: [...] }

SDKs & Libraries

Official client libraries for popular languages and frameworks.

⚛

JavaScript / TypeScript

Node.js, Deno, Bun, and browser

npm i @inertia/style-sdk

🐍

Python

Python 3.8+ with async support

pip install inertia-sdk

♦

Ruby

Ruby 3.0+ with Rails integration

gem install inertia_style

Support

Need help? Our developer relations team is here to assist.

Developer Discord

Join 3,000+ developers building with Inertia. Get help, share projects, and connect with the team.

Join Community →

GitHub

Report bugs, request features, and contribute to our open-source SDKs and example projects.

View Repository →

Email Support

Premium and VIP members get priority email support with guaranteed 4-hour response times.

api@inertiaclothing.net →

Status Page

Monitor real-time API uptime, latency metrics, and subscribe to incident notifications.

Check Status →