API Documentation — SignalAI House

Authentication

All API requests require authentication via a Bearer token in the Authorization header.

HTTP Header

Authorization: Bearer YOUR_API_KEY

You can generate API keys from your dashboard after signing up. Keep your keys secure and never expose them in client-side code.

Chat API

Send messages and receive AI-generated responses.

Endpoint

POST

https://api.signalaihouse.com/v1/chat

Request Body

JSON

{
  "model": "signal-1",
  "messages": [
    {
      "role": "user",
      "content": "What is quantum computing?"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}

Response

JSON

{
  "id": "chat_abc123",
  "model": "signal-1",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Quantum computing is a type of computation..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  }
}

Code Examples

curl -X POST https://api.signalaihouse.com/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "signal-1",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

import requests

response = requests.post(
    "https://api.signalaihouse.com/v1/chat",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "signal-1",
        "messages": [{"role": "user", "content": "Hello!"}]
    }
)

print(response.json())

const response = await fetch(
  'https://api.signalaihouse.com/v1/chat',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'signal-1',
      messages: [{ role: 'user', content: 'Hello!' }]
    })
  }
);

const data = await response.json();
console.log(data);

Available Models

Choose the model that best fits your use case and budget.

Model	Price / 1K tokens	Max Tokens	Best For
`signal-1`	$0.0005	4,096	General conversations
`signal-1-turbo`	$0.0008	4,096	Faster responses
`signal-1-pro`	$0.0015	8,192	Complex reasoning

Rate Limits

Rate limits vary by plan to ensure fair usage for all users.

Plan	Requests / Minute	Tokens / Day
Starter	20	50,000
Pro	60	500,000
Enterprise	Custom	Unlimited

Error Handling

The API uses standard HTTP status codes and returns detailed error messages.

Code	Meaning	Description
200	Success	Request processed successfully
400	Bad Request	Invalid or missing parameters
401	Unauthorized	Invalid or missing API key
429	Rate Limited	Too many requests, slow down
500	Server Error	Internal error, try again later

SDKs & Libraries

Official SDKs are coming soon for all major languages.

Python (coming soon)

pip install signalai

JavaScript / Node.js (coming soon)

npm install @signalai/sdk

PHP (coming soon)

composer require signalai/sdk