SocAIty SDK
Build AI-powered applications with ease
## Introduction
The **Socaity TypeScript SDK** simplifies integration with **[Socaity.ai](https://www.socaity.ai)**, a leading platform for AI-powered content generation, including **text-to-image**, **text-to-speech**, **face swapping**, **chat models**, and more.
With a lightweight footprint (**UMD ~25KB, ES ~30KB**), this SDK lets you seamlessly interact with Socaity's hosted AI models using simple, intuitive API calls.
A complete list of all models can be found [here](https://www.socaity.ai/APIs/Overview).
## 🚀 Why Use the Socaity SDK?
- **One-liner AI calls** – No need to handle raw API requests.
- **Asynchronous & performant** – Optimized for parallel processing.
- **Supports multiple AI models** – Text, images, voice cloning, deep fakes, virutal avatars and more.
- **File handling included** – Upload/download images with ease.
- **Works with Node.js & Browser** – Supports ES modules and UMD builds.
## Installation
Install via **npm** or **yarn**:
```sh
npm install socaity
# or
yarn add socaity
```
## Quick Start
### 1️⃣ Import the SDK
```typescript
import { socaity } from "socaity";
import dotenv from "dotenv";
dotenv.config(); // Load API key from .env file
socaity.setApiKey(process.env.SOCAITY_API_KEY); // we recommend settting the API key with environment variables.
```
Register and [get your API key](https://www.socaity.ai/signinup?page_state=0)
### 2️⃣ Generate an AI Image
```typescript
async function generateImage() {
const images = await socaity.text2img("A futuristic city at sunset", "flux-schnell", { num_outputs: 1 });
await images[0].save("output/futuristic_city.jpg");
}
```
### 3️⃣ AI Chat with SOTA LLMs Models
```typescript
async function chatWithAI() {
const response = await socaity.chat("Explain why an SDK is better than direct API calls.");
console.log(response);
}
```
### 4️⃣ Face Swapping Made Easy
```typescript
async function swapFaces() {
const result = await socaity.swapImg2Img("data/source.jpg", "data/target.jpg");
await result.save("output/face_swap.jpg");
}
```
## Advanced Usage
### Running Multiple Requests in Parallel
```typescript
const [img1, img2] = await Promise.all([
socaity.text2img("A cyberpunk landscape", "flux-schnell"),
socaity.chat("Describe quantum physics in simple terms.")
]);
```
### Embedding images
```typescript
await image.save("path/to/save.jpg");
```
### Working directly with your favorite models.
## Browser & Node.js Support
- **Node.js:** Works with `import { socaity } from "socaity"`.
- **Browser:** Use the UMD build: ``.
You might be interested also in the [python SDK](https://github.com/SocAIty/socaity)
## Contributing
We welcome contributions! Submit PRs or report issues in the GitHub Repos or in the Help section of your socaity account.
## License
This SDK is open-source and available under the **MIT License**.
### 🌟 Star this repo if you find it useful!
Note: We are in alpha version. Thus expect rapid changes to the SDK, APIs and more models to be added frequently.