Aistyla API Documentation

Introduction

Aistyla is a powerful API-first SaaS platform that enables businesses to integrate modern AI-driven fashion try-on capabilities. Upload clothing items, select or provide a user image, and generate realistic styled looks with clean white backgrounds — all via simple and secure APIs.

AI-Powered Try-On

See how clothes look on a real person or selectable model using advanced AI rendering.

Product Upload API

Upload tops, bottoms, shoes, scarves, and more.

Look Generation API

Create complete styled looks from top to bottom.

Getting Started

To start using the Aistyla API, you'll need to register for an account and obtain your API key.

1

Register for an Account

Create an account at aistyla.com/register

2

Get Your API Key

Once registered, you can find your API key in your account dashboard.

3

Make Your First API Call

Use your API key to authenticate and start making requests.

Authentication

All API requests require authentication using a Bearer Token in the Authorization header.

HTTP Request Header

Authorization: Bearer YOUR_API_TOKEN

Obtaining a Token

You can obtain a token by making a POST request to the /v1/login endpoint with your credentials:

Request

curl -X POST https://api.aistyla.com/v1/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=your_email@example.com&password=your_password"

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

API Endpoints

Register

POST /v1/register

Register a new user account.

Request Body

{
  "email": "user@example.com",
  "password": "securepassword",
  "full_name": "John Doe",
  "company": "Fashion Inc."
}

Response

{
  "id": "user_id",
  "email": "user@example.com",
  "full_name": "John Doe",
  "company": "Fashion Inc.",
  "created_at": "2025-03-28T01:22:36Z"
}

Login

POST /v1/login

Authenticate and get an access token.

Request Body

username=user@example.com&password=securepassword

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

Upload Item

POST /v1/upload-item

Upload a new clothing item.

Request Body (multipart/form-data)

file: [binary image data]
name: "Blue T-Shirt"
type: "top"
description: "Comfortable cotton t-shirt"
brand: "Fashion Brand"
color: "blue"
tags: ["casual", "summer"]

Response

{
  "id": "item_id",
  "name": "Blue T-Shirt",
  "type": "top",
  "description": "Comfortable cotton t-shirt",
  "brand": "Fashion Brand",
  "color": "blue",
  "tags": ["casual", "summer"],
  "image_url": "https://storage.aistyla.com/items/blue-tshirt.jpg",
  "created_at": "2025-03-28T01:22:36Z",
  "updated_at": "2025-03-28T01:22:36Z"
}

Get Items

GET /v1/items

Get all items for the authenticated user.

Query Parameters

Parameter	Type	Description
type	string	Filter by item type (top, bottom, shoes, etc.)

Response

[
  {
    "id": "item_id_1",
    "name": "Blue T-Shirt",
    "type": "top",
    "image_url": "https://storage.aistyla.com/items/blue-tshirt.jpg",
    "created_at": "2025-03-28T01:22:36Z",
    "updated_at": "2025-03-28T01:22:36Z"
  },
  {
    "id": "item_id_2",
    "name": "Black Jeans",
    "type": "bottom",
    "image_url": "https://storage.aistyla.com/items/black-jeans.jpg",
    "created_at": "2025-03-28T01:22:36Z",
    "updated_at": "2025-03-28T01:22:36Z"
  }
]

Get Models

GET /v1/models

Get available models for try-on.

Query Parameters

Parameter	Type	Description
gender	string	Filter by gender (male, female)
body_type	string	Filter by body type
ethnicity	string	Filter by ethnicity

Response

[
  {
    "id": "model_id_1",
    "name": "Model 1",
    "gender": "female",
    "body_type": "slim",
    "ethnicity": "asian",
    "image_url": "https://storage.aistyla.com/models/model1.jpg"
  },
  {
    "id": "model_id_2",
    "name": "Model 2",
    "gender": "male",
    "body_type": "athletic",
    "ethnicity": "caucasian",
    "image_url": "https://storage.aistyla.com/models/model2.jpg"
  }
]

Generate Look

POST /v1/generate-look

Generate a styled look with selected items and model.

Request Body

{
  "model_id": "model_id_1",
  "items": ["item_id_1", "item_id_2"],
  "style": "casual",
  "background": "white"
}

Response

{
  "id": "look_id",
  "model_id": "model_id_1",
  "items": ["item_id_1", "item_id_2"],
  "style": "casual",
  "background": "white",
  "image_url": "https://storage.aistyla.com/looks/look1.jpg",
  "created_at": "2025-03-28T01:22:36Z"
}

Get Looks

GET /v1/looks

Get all generated looks for the authenticated user.

Response

[
  {
    "id": "look_id_1",
    "model_id": "model_id_1",
    "style": "casual",
    "image_url": "https://storage.aistyla.com/looks/look1.jpg",
    "created_at": "2025-03-28T01:22:36Z"
  },
  {
    "id": "look_id_2",
    "model_id": "model_id_2",
    "style": "formal",
    "image_url": "https://storage.aistyla.com/looks/look2.jpg",
    "created_at": "2025-03-28T01:22:36Z"
  }
]

Code Examples

Upload an Item

cURL

curl -X POST https://api.aistyla.com/v1/upload-item \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@/path/to/image.jpg" \
  -F "name=Blue T-Shirt" \
  -F "type=top" \
  -F "description=Comfortable cotton t-shirt" \
  -F "brand=Fashion Brand" \
  -F "color=blue" \
  -F "tags=[\"casual\", \"summer\"]"

Generate a Look

cURL

curl -X POST https://api.aistyla.com/v1/generate-look \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "model_id_1",
    "items": ["item_id_1", "item_id_2"],
    "style": "casual",
    "background": "white"
  }'

Upload an Item

JavaScript

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('name', 'Blue T-Shirt');
formData.append('type', 'top');
formData.append('description', 'Comfortable cotton t-shirt');
formData.append('brand', 'Fashion Brand');
formData.append('color', 'blue');
formData.append('tags', JSON.stringify(['casual', 'summer']));

fetch('https://api.aistyla.com/v1/upload-item', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_TOKEN}`
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Generate a Look

JavaScript

const lookData = {
  model_id: 'model_id_1',
  items: ['item_id_1', 'item_id_2'],
  style: 'casual',
  background: 'white'
};

fetch('https://api.aistyla.com/v1/generate-look', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(lookData)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Upload an Item

Python

import requests
import json

url = 'https://api.aistyla.com/v1/upload-item'
headers = {
    'Authorization': f'Bearer {YOUR_API_TOKEN}'
}

files = {
    'file': open('/path/to/image.jpg', 'rb')
}

data = {
    'name': 'Blue T-Shirt',
    'type': 'top',
    'description': 'Comfortable cotton t-shirt',
    'brand': 'Fashion Brand',
    'color': 'blue',
    'tags': json.dumps(['casual', 'summer'])
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

Generate a Look

Python

import requests
import json

url = 'https://api.aistyla.com/v1/generate-look'
headers = {
    'Authorization': f'Bearer {YOUR_API_TOKEN}',
    'Content-Type': 'application/json'
}

data = {
    'model_id': 'model_id_1',
    'items': ['item_id_1', 'item_id_2'],
    'style': 'casual',
    'background': 'white'
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())

SDKs & Libraries

We provide official client libraries for several programming languages to make integration even easier.

JavaScript

Official JavaScript/TypeScript SDK for Node.js and browser environments.

View on npm

Python

Official Python SDK for server-side applications.

View on PyPI

PHP

Official PHP SDK for web applications.

View on Packagist