Get Started with Realigns AI API
Chat + Voice AI for Apps, SaaS, and Industrial Systems
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.
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.
1. Send user input to
/ai/chat2. Receive text response
3. Convert response to audio via
/voice/tts4. 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.
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
🎤 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.
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
🧾 Pricing Overview
Realigns AI uses request-based pricing, designed for developers, businesses, and industrial systems.
Developer
Apps, testing, prototypes
$9 / monthBusiness
SaaS, websites, automation
$79 / monthIoT / Industrial
Kiosks, factories, devices
$299 / monthEnterprise
On-prem / private deployment
CustomPricing 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
IoT & Industrial Integration
Designed for always-on industrial systems such as kiosks, factory terminals, warehouse devices, and smart panels.
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
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.