Learn how to setup your project to use the SDK.

Setup


## Welcome to itWrites APIs

At itWrites, we harness the transformative power of artificial intelligence to offer a suite of robust API services designed to revolutionize industries and enhance digital experiences. Our APIs are meticulously crafted to provide innovative solutions that drive efficiency, creativity, and growth.

## Why Choose itWrites?

### Industry-Leading Technology
Our platform utilizes state-of-the-art machine learning models and algorithms to ensure that you receive the most accurate, efficient, and reliable services available today. From virtual fashion fitting rooms and personalized skincare recommendations to predictive market analysis and automated legal document processing, our diverse API catalog is designed to meet the dynamic needs of modern businesses.

### Developer-Friendly Integration
itWrites APIs are built with developers in mind. We provide comprehensive documentation, easy-to-use endpoints, and extensive support to ensure seamless integration and a smooth development experience. Whether you are a startup or an established enterprise, our APIs are designed to be flexible and scalable to fit your specific requirements.

### Empowering Businesses
By integrating itWrites APIs, companies can:
- **Reduce Operational Costs**: Automate routine tasks and processes, reducing the need for manual intervention and lowering operational expenses.
- **Enhance Customer Experience**: Utilize our APIs to provide personalized experiences, from shopping and design to customer support.
- **Drive Innovation**: Leverage our AI capabilities to explore new business models and strategies, staying ahead of the curve in a rapidly evolving digital landscape.

### Security and Reliability
Security is paramount at itWrites. We adhere to the highest standards of data protection and privacy, ensuring that your data and that of your users are safe at all times. Our systems are designed for high availability and scalability to handle any demand peaks without compromising on performance.

## Get Started with itWrites

Join the forefront of the technological revolution by integrating itWrites APIs into your applications. Enhance your product offerings, streamline your operations, and deliver unmatched value to your customers.

>Begin by exploring our [Getting Started guide](https://beta.itwrites.ai/docs/getting-started) to set up your itWrites account and dive into the world of opportunities with our APIs. Our team is here to support you at every step of the way, ensuring that your journey with itWrites is successful.

Discover the potential of itWrites and transform your business with the power of AI. Let us help you innovate and lead in your industry.


Discover how itWrites leverages advanced AI technology to power transformative solutions across various industries. Learn how our APIs can benefit developers and companies to innovate and lead in their markets.

Introduction to itWrites API Services


## Welcome to itWrites

Embark on your journey with itWrites, where advanced AI meets practical applications. Our APIs are tailored to empower developers and companies by providing cutting-edge tools across diverse industries, from fashion and real estate to legal and security services.

## Step-by-Step Setup Guide

To utilize the itWrites API services, follow these straightforward steps to get started:

### 1. Sign Up
Start by creating your account. Register [here](https://beta.itwrites.ai/auth/sign-up) by providing the necessary details to set up your user profile.

### 2. Create an Organization
Once your account is active, log in and go to the [Organization Settings](https://beta.itwrites.ai/settings/organization) page. Here, create your organization which will help you manage your projects and API usage.

### 3. Generate an API Key
Navigate to the 'API Keys' section within your organization settings. Click 'Generate New API Key' and securely store this key; it is crucial for all your API requests and cannot be retrieved once lost.

## Integrating itWrites APIs

Once your setup is complete, you are ready to integrate our APIs into your applications:

- Visit the [Services Page](https://beta.itwrites.ai/services) to explore the available APIs.
- Select an API and review its documentation for specific integration guidelines and endpoint details.
- Ensure that your API key is included in the request header as shown in our examples.

### Example: Using the Mannequin to Human Generator API

This Node.js example demonstrates calling the Mannequin to Human Generator API using the `axios` library to send HTTP requests.

```javascript
const axios = require('axios');

const apiKey = 'YOUR_API_KEY'; // Replace this with your actual API key
const apiUrl = 'https://beta.itwrites.ai/ai-fashion-models/mannequin-generator';

const imageBase64 = 'data:image/jpeg;base64,...'; // Your base64 image string
const maskImageBase64 = 'data:image/jpeg;base64,...'; // Your base64 mask image string

const headers = {
  'Content-Type': 'application/json',
  'x-itwrites-token': apiKey
};

const data = {
  photo: imageBase64,
  photo_mask: maskImageBase64
};

axios.post(apiUrl, data, { headers })
  .then(response => {
    console.log('API Call Successful:', response.data);
  })
  .catch(error => {
    console.error('API Call Failed:', error.response.data);
  });


````

Get up and running with itWrites APIs. This guide provides all the necessary steps to register, set up your account, and start integrating our advanced AI services into your applications.

Getting Started with itWrites AI APIs

Get started with the platform and learn how to use it.

Debugging


## Introduction to API Error Codes

When using the itWrites API, you may encounter various error codes that signify different issues within your requests or our service. Understanding these error codes is crucial for efficient troubleshooting and error handling. Below is a comprehensive list of all possible error codes and their meanings.

### Common Error Codes

#### 401 MISSING_VARIABLES

```yaml
Code: 401
Message: Missing required variables in the request.
Resolution: Ensure all required fields are included in your API request.
```

#### 100 Service Not Found

```yaml
Code: 100
Message: Service not found.
Resolution: Verify the endpoint URL and ensure you're accessing a valid service.
```

#### 101 Invalid API Key

```yaml
Code: 101
Message: Invalid API key.
Resolution: Check your API key for accuracy and ensure it hasn't expired or been revoked.
```

#### 102 No Valid Credits Available

```yaml
Code: 102
Message: No valid credits available.
Resolution: Ensure your account has the necessary credits to perform the requested operation.
```

#### 103 Insufficient Credits

```yaml
Code: 103
Message: Insufficient credits.
Resolution: Top up your account credits to continue using the services without interruption.
```

#### 104 Transaction Failure

```yaml
Code: 104
Message: Credit management failed.
Resolution: There was an error processing a transaction related to your credits. Please try again or contact support if the issue persists.
```

#### 105 Unknown Error

```yaml
Code: 105
Message: An unknown error occurred.
Resolution: An unexpected issue occurred. Contact support for further investigation.
```

#### 106 Invalid Service

```yaml
Code: 106
Message: Invalid service.
Resolution: The requested service does not exist. Check the request for typos or outdated information.
```

#### 107 Invalid Service Token

```yaml
Code: 107
Message: Invalid service token.
Resolution: The provided service token is invalid or expired. Obtain a new token and try again.
```

#### 108 Invalid Service Engine

```yaml
Code: 108
Message: Invalid service engine.
Resolution: The specified engine for the service is incorrect or unavailable.
```

#### 109 Engine Error

```yaml
Code: 109
Message: Engine error.
Resolution: An error occurred within the processing engine. Try again later or report the issue.
```

#### 110 Engine Error Cost Missing

```yaml
Code: 110
Message: Engine error cost missing.
Resolution: The cost of processing could not be calculated. Verify the request parameters and try again.
```

#### 111 Invalid Engines Options

```yaml
Code: 111
Message: Invalid engines options.
Resolution: The options provided for the engine are invalid. Refer to the documentation for the correct options.
```

#### 112 Invalid Service Settings

```yaml
Code: 112
Message: Invalid service settings.
Resolution: The configuration for the service is incorrect or not supported. Review and update the settings as necessary.
```

#### 113 Invalid Service Organization

```yaml
Code: 113
Message: Invalid service organization.
Resolution: The organization information provided does not match our records. Ensure the organization details are correct.
```

#### 114 Server Error Config

```yaml
Code: 114
Message: Server error config.
Resolution: There is a configuration error on the server. Contact technical support for assistance.
```

#### 114 Not Mapped

```yaml
Code: 114
Message: Not mapped.
Resolution: An error code has been reused or not properly mapped to a unique issue. This may require further clarification from support.
```

---

By familiarizing yourself with these error codes, you can more effectively diagnose and solve issues as they arise during your integration and use of the itWrites API. If you need additional help, don't hesitate to contact our support team at support@itwrites.ai .


Detailed explanation of each error code returned by the itWrites API. This guide helps developers understand and troubleshoot errors encountered during API integration.

API Error Codes - itWrites

Learn how to manage your billing information and view your invoices.

Billing


## Overview of Subscriptions

To access and use the itWrites API services, organizations must have credits, which are acquired through subscriptions. This guide details the types of subscriptions available, how to purchase them, and the rules regarding the usage and expiration of credits.

### Purchasing Subscriptions

Organizations can purchase subscriptions by visiting the subscription management page:

[Manage Subscriptions](https://beta.itwrites.ai/settings/subscription)

Subscriptions are available on either a monthly or yearly basis, providing flexibility depending on your usage needs and budget.

### Subscription Types and Credits

Each subscription tier offers a specific amount of credits that can be used within the itWrites API:

 **Monthly Subscription:** Renews every month and provides a set amount of credits for that duration.
 **Yearly Subscription:** Provides a discounted rate compared to monthly billing and supplies credits for the entire year.

### Credit Usage

Credits obtained through a subscription can be used to perform operations within the itWrites API. Each action or request costs a certain number of credits, detailed in our API documentation under the specific service descriptions.

### If You Run Out of Credits

If your organization depletes all its credits before the subscription period ends, you have the option to:

 **Purchase an Additional Subscription:** This will reset your credit balance to the full amount of the new subscription, starting from the date of purchase.
 **Wait for the Next Billing Cycle:** Your credits will automatically replenish when your next subscription period begins.

### Credit Expiration

Credits are tied to the subscription period and do not roll over to the next period. They expire at the end of each subscription cycle, on the same date that the subscription was paid. It's important to plan your usage to ensure that you maximize the value of your credits.

### Managing Your Subscription

You can view details about your current subscription, manage settings, and make changes by visiting:

[Subscription Settings](https://beta.itwrites.ai/settings/subscription)

### Renewals and Cancellations

Subscriptions automatically renew according to the chosen billing cycle (monthly or yearly). You can cancel your subscription at any time from the subscription settings page. However, please note that cancellation will take effect at the end of the current billing period, and unused credits will expire and cannot be refunded.

---

Understanding and managing your subscription effectively will ensure that your organization can continuously leverage the itWrites API without interruption. For further questions or assistance with subscriptions, please contact our support team.


Understand how to purchase and manage subscriptions for using the itWrites API. Learn about the credit system and how it aligns with our subscription models.

Subscription Details - itWrites API

"use strict";
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
function _createMdxContent(props) {
  const _components = {
    a: "a",
    h2: "h2",
    h3: "h3",
    hr: "hr",
    p: "p",
    span: "span",
    strong: "strong",
    ...props.components
  };
  return _jsxs(_Fragment, {
    children: [_jsxs(_components.h2, {
      id: "overview-of-subscriptions",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#overview-of-subscriptions",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Overview of Subscriptions"]
    }), "\n", _jsx(_components.p, {
      children: "To access and use the itWrites API services, organizations must have credits, which are acquired through subscriptions. This guide details the types of subscriptions available, how to purchase them, and the rules regarding the usage and expiration of credits."
    }), "\n", _jsxs(_components.h3, {
      id: "purchasing-subscriptions",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#purchasing-subscriptions",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Purchasing Subscriptions"]
    }), "\n", _jsx(_components.p, {
      children: "Organizations can purchase subscriptions by visiting the subscription management page:"
    }), "\n", _jsx(_components.p, {
      children: _jsx(_components.a, {
        href: "https://beta.itwrites.ai/settings/subscription",
        children: "Manage Subscriptions"
      })
    }), "\n", _jsx(_components.p, {
      children: "Subscriptions are available on either a monthly or yearly basis, providing flexibility depending on your usage needs and budget."
    }), "\n", _jsxs(_components.h3, {
      id: "subscription-types-and-credits",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#subscription-types-and-credits",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Subscription Types and Credits"]
    }), "\n", _jsx(_components.p, {
      children: "Each subscription tier offers a specific amount of credits that can be used within the itWrites API:"
    }), "\n", _jsxs(_components.p, {
      children: [_jsx(_components.strong, {
        children: "Monthly Subscription:"
      }), " Renews every month and provides a set amount of credits for that duration.\n", _jsx(_components.strong, {
        children: "Yearly Subscription:"
      }), " Provides a discounted rate compared to monthly billing and supplies credits for the entire year."]
    }), "\n", _jsxs(_components.h3, {
      id: "credit-usage",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#credit-usage",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Credit Usage"]
    }), "\n", _jsx(_components.p, {
      children: "Credits obtained through a subscription can be used to perform operations within the itWrites API. Each action or request costs a certain number of credits, detailed in our API documentation under the specific service descriptions."
    }), "\n", _jsxs(_components.h3, {
      id: "if-you-run-out-of-credits",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#if-you-run-out-of-credits",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "If You Run Out of Credits"]
    }), "\n", _jsx(_components.p, {
      children: "If your organization depletes all its credits before the subscription period ends, you have the option to:"
    }), "\n", _jsxs(_components.p, {
      children: [_jsx(_components.strong, {
        children: "Purchase an Additional Subscription:"
      }), " This will reset your credit balance to the full amount of the new subscription, starting from the date of purchase.\n", _jsx(_components.strong, {
        children: "Wait for the Next Billing Cycle:"
      }), " Your credits will automatically replenish when your next subscription period begins."]
    }), "\n", _jsxs(_components.h3, {
      id: "credit-expiration",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#credit-expiration",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Credit Expiration"]
    }), "\n", _jsx(_components.p, {
      children: "Credits are tied to the subscription period and do not roll over to the next period. They expire at the end of each subscription cycle, on the same date that the subscription was paid. It's important to plan your usage to ensure that you maximize the value of your credits."
    }), "\n", _jsxs(_components.h3, {
      id: "managing-your-subscription",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#managing-your-subscription",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Managing Your Subscription"]
    }), "\n", _jsx(_components.p, {
      children: "You can view details about your current subscription, manage settings, and make changes by visiting:"
    }), "\n", _jsx(_components.p, {
      children: _jsx(_components.a, {
        href: "https://beta.itwrites.ai/settings/subscription",
        children: "Subscription Settings"
      })
    }), "\n", _jsxs(_components.h3, {
      id: "renewals-and-cancellations",
      children: [_jsx(_components.a, {
        "aria-hidden": "true",
        tabIndex: "-1",
        href: "#renewals-and-cancellations",
        children: _jsx(_components.span, {
          className: "icon icon-link"
        })
      }), "Renewals and Cancellations"]
    }), "\n", _jsx(_components.p, {
      children: "Subscriptions automatically renew according to the chosen billing cycle (monthly or yearly). You can cancel your subscription at any time from the subscription settings page. However, please note that cancellation will take effect at the end of the current billing period, and unused credits will expire and cannot be refunded."
    }), "\n", _jsx(_components.hr, {}), "\n", _jsx(_components.p, {
      children: "Understanding and managing your subscription effectively will ensure that your organization can continuously leverage the itWrites API without interruption. For further questions or assistance with subscriptions, please contact our support team."
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = props.components || ({});
  return MDXLayout ? _jsx(MDXLayout, {
    ...props,
    children: _jsx(_createMdxContent, {
      ...props
    })
  }) : _createMdxContent(props);
}
return {
  default: MDXContent
};


Setup

Debugging

Billing

Subscriptions

Understand how to purchase and manage subscriptions for using the itWrites API. Learn about the credit system and how it aligns with our subscription models.

Overview of Subscriptions

Purchasing Subscriptions

Subscription Types and Credits

Credit Usage

If You Run Out of Credits

Credit Expiration

Managing Your Subscription

Renewals and Cancellations

Table of Contents