SocAIty SDK

Build AI-powered applications with ease

Introduction

The Socaity TypeScript SDK simplifies integration with 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.

🚀 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:

npm install socaity

Quick Start

1️⃣ Import the SDK

import { socaity } from "socaity";
socaity.setApiKey('sk...'); // we recommend settting the API key with environment variables. 

Register and get your API key

2️⃣ Generate an AI Image

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

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

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

const [img, chat_response] = await Promise.all([
  socaity.text2img("A cyberpunk landscape", "flux-schnell"),
  socaity.chat("Describe quantum physics in simple terms.")
]);

Working with files (Media-toolkit)

The SocAIty SDK includes a powerful MediaFile toolkit that simplifies handling files across both Node.js and browser environments. Look here to learn more about it.

Working directly with your favorite models.

Many models are directly importable by the module. Some of them have specialized methods and parameters which are not included to the simple usage wrapper methods like socaity.text2img.

import { FluxSchnell } from "socaity";
FluxSchnell.text2img("Rick and Morty swimming in a lake", { 
    num_outputs: 3,   
    aspect_ratio: "16:9",
    num_outputs: 3,
    num_inference_steps: 5}
).then(images => { ... });

Browser & Node.js Support

• Node.js: Works with import { socaity } from "socaity".
• Browser: Use the UMD build: <script src="socaity.umd.js"></script>.

You might be interested also in the python SDK

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.