Get Started with Realigns AI API

Chat + Voice AI for Apps, SaaS, and Industrial Systems

Sign Up
Create Key
Quickstart
First Request
Deploy

Registration Workflow

Step 1 Create an Account

Sign up at the Realigns Portal with your business email. Once verified, your dashboard becomes the central hub for your API activity.

Note: Your unique Realigns API key will be generated and sent directly to your dashboard upon verification.

Step 2 Generate Your API Key

Navigate to the API Keys tab in your dashboard and click "Create New Key".

Security First: Your API key is used to authenticate requests. Do not share it publicly or commit it to frontend code.

Quickstart Guide

Use these snippets to send your first message to the Realigns Gateway.

Example cURL

curl -X POST https://gpt-api.realignsinc.com/ai/chat \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"prompt": "Hello!"}'

Example JavaScript

await fetch('https://gpt-api.realignsinc.com/ai/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({ prompt: 'Hello!' })
});

Chat + Voice Integration Flow

Realigns AI v2.0 (Beta) supports a two-step Chat → Voice pipeline, suitable for apps, SaaS platforms, kiosks, and smart devices.

Logic Flow:
1. Send user input to /ai/chat
2. Receive text response
3. Convert response to audio via /voice/tts
4. Play audio on client or device
User Input → POST /ai/chat → AI Text Reply → POST /voice/tts → WAV Audio → Speaker
            

🔁 Streaming Voice (Beta)

Realigns AI supports near real-time voice playback by streaming TTS audio in short WAV chunks. This is ideal for assistants, kiosks, and conversational interfaces where waiting for full audio is not acceptable.

Streaming Concept:
Text is generated → split into chunks → each chunk converted to audio → played immediately while the next chunk is processed.
AI Text Reply
   ↓
Chunk Split (sentences / phrases)
   ↓
POST /voice/tts (per chunk)
   ↓
Immediate Playback
Streaming is currently implemented at the application level. Native server-side streaming endpoints may be introduced in future releases.

🎤 Speech-to-Text (Future-Ready)

Speech-to-Text (STT) is planned as a future Realigns AI module to enable full Voice → AI → Voice interaction for devices and applications.

Planned Flow:
User Speech → STT → Chat AI → TTS → Audio Response
Mic Input
   ↓
Speech-to-Text (STT)
   ↓
POST /ai/chat
   ↓
POST /voice/tts
   ↓
Speaker Output

STT will be designed for industrial noise tolerance, short utterances, and device-friendly performance.

📦 Quick Deploy for Factories

This section outlines a minimal, production-ready deployment for factories, warehouses, and industrial environments.

Factory Device (Mic / Button / Sensor)
        ↓
Local Gateway / Industrial PC
        ↓
Realigns AI API
        ↓
Voice Output / Display

Recommended Stack

  • Industrial PC / Edge Gateway
  • Linux or Windows
  • Node.js / Python backend
  • Local speaker or PA system

Why This Works

  • No cloud lock-in
  • Predictable monthly cost
  • Works with unreliable internet
  • No API key exposure on devices
API keys must remain on the gateway only — never inside PLCs, firmware, or embedded device storage.

🧾 Pricing Overview

Realigns AI uses request-based pricing, designed for developers, businesses, and industrial systems.

Developer

Apps, testing, prototypes

$9 / month

Business

SaaS, websites, automation

$79 / month

IoT / Industrial

Kiosks, factories, devices

$299 / month

Enterprise

On-prem / private deployment

Custom

Pricing is predictable and typically 60–80% lower than traditional token-based AI platforms.

Apps & SaaS Integration

For mobile apps and SaaS platforms, Realigns AI must be accessed through a secure backend proxy. API keys should never be embedded in frontend or mobile code.

Recommended Architecture

Mobile/Web App  ⇄  Your Secure Backend  ⇄  Realigns AI Gateway
Best Practice: Cache chat responses where possible to reduce repeated TTS calls and lower latency.

IoT & Industrial Integration

Designed for always-on industrial systems such as kiosks, factory terminals, warehouse devices, and smart panels.

Security Alert: IoT devices should never store API keys directly. Always route requests through a secured gateway or controller.

Device-Friendly Design

  • Low-latency voice replies
  • Predictable request-based billing
  • Short prompt optimization

Test in Browser or Postman

You can use Postman or Insomnia to test the endpoint manually:

  • Method: POST
  • URL: https://gpt-api.realignsinc.com/ai/chat
  • Headers: x-api-key: YOUR_API_KEY

Sample Response

{
  "reply": "Cats sleep for about 70% of the day.",
  "status": "success"
}

Quota & Usage

Current Monthly Usage

TOKENS REMAINING
9,732
REQUESTS MADE
142

FAQ & Troubleshooting

401 Unauthorized

Your API key is invalid or missing. Ensure the x-api-key header is correctly set.

Key Rotation

Go to Dashboard > API Keys and click the rotate icon to instantly void the old key and generate a new one.