Documentation

API Documentation

Everything you need to integrate Niotex Studio's AI-powered product photography into your application.

Authentication

All API requests require authentication using an API key. You can create and manage your API keys from the dashboard.

Include your API key in the X-API-Key header:

X-API-Key: ns_live_xxxxxxxxxxxx

Quick Start

Make Your First API Call

Choose your programming language and follow the example below

curl -X POST https://studio.niotex.com/api/v1/process \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/product.jpg",
    "options": {
      "removeBackground": true,
      "studioLighting": true,
      "outputFormat": "png",
      "size": "1024x1024"
    }
  }'

API Endpoints

POST/v1/processAuth
GET/v1/imagesAuth
GET/v1/images/:idAuth
GET/v1/keysAuth
POST/v1/keysAuth
DELETE/v1/keys/:idAuth

Image Processing Options

The /v1/process endpoint accepts the following options:

removeBackgroundbooleandefault: true

Remove the background from the product image

studioLightingbooleandefault: true

Apply professional studio lighting effects

outputFormatstringdefault: "png"

Output format: "png", "jpg", or "webp"

sizestringdefault: "1024x1024"

Output size: "1024x1024", "1792x1024", or "1024x1792"

stylestringdefault: "natural"

Image style: "natural" or "vivid"

Error Handling

401API_KEY_REQUIREDNo API key provided in the request
401API_KEY_INVALIDThe provided API key is invalid or revoked
402SUBSCRIPTION_REQUIREDAn active subscription is required
402TRIAL_EXPIREDYour free trial has expired
400IMAGE_REQUIREDNo image provided in the request
500PROCESSING_FAILEDFailed to process the image
429RATE_LIMIT_EXCEEDEDToo many requests

Rate Limits

Rate limits are applied per API key and depend on your subscription plan:

Starter

100 requests/minute

1,000 images/month

Professional

500 requests/minute

10,000 images/month

Enterprise

Unlimited requests

Unlimited images

Need Help?

Our support team is here to help you integrate Niotex Studio.