SoVael API

Build AI-powered business automation into your own products. The same API that powers SoVael's own agents — now available to you.

Authentication: Pass your API key as X-API-Key header or Authorization: Bearer <key>.
Get a key: curl https://api.sovael.ai/api/v1/subscribe -X POST -H "Content-Type: application/json" -d '{"plan":"starter"}'

Plans

Plan	Price	Daily Limit	Key Features
Starter £29/mo	£29	1,000 req/day	Chat API, webhooks, conversation memory
Business £99/mo	£99	10,000 req/day	+Voice, filesystem, YouTube, batch processing
Enterprise £249/mo	£249	50,000 req/day	+Phantom Browser, MCP, CAPTCHA solving, dedicated proxy

Endpoints

POST/chat

Send a message to the SoVael LLM. Returns AI-generated response. Supports conversation context via conversation_id.

Body: {"message": "string", "conversation_id": "optional-uuid"}

POST/voice/synthesize

Convert text to speech. Requires Business plan or higher.

POST/voice/transcribe

Convert audio to text. Requires Business plan or higher.

POST/webhooks/n8n

Trigger n8n workflows. Forward data to your SoVael-connected automation.

GET/health

System health check. Public — no API key needed.

GET/status

System status and capabilities. Public — no API key needed.

Rate Limits

Rate limits apply per API key. Exceeding the limit returns HTTP 429 with a Retry-After header.

Rate limit headers are returned on every response: X-RateLimit-Remaining, X-RateLimit-Plan.

Get Started

# Get a free Starter API key
curl https://api.sovael.ai/api/v1/subscribe \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"plan":"starter"}'

# Use it to send a chat message
curl https://api.sovael.ai/chat \
  -H "X-API-Key: sovael_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello, what can you do?"}'

# Verify your key
curl https://api.sovael.ai/api/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"api_key":"sovael_your_key_here"}'

SDK & Client

Any HTTP client works. No official SDK yet — just use curl, Python requests, JavaScript fetch, or your language of choice.

# Python example
import requests
resp = requests.post(
    "https://api.sovael.ai/chat",
    headers={"X-API-Key": "sovael_your_key_here"},
    json={"message": "What can you automate?"}
)
print(resp.json())